diff --git a/source/home.md b/source/home.md index 8a405c4c24b25c63cc127d7ef52211ac19c13cfc..66491f5fd4dfc0f3a548ea4f3bd741df0d6b4d3c 100644 --- a/source/home.md +++ b/source/home.md @@ -1,4 +1,10 @@ - +--- +title: Getting Started +author: David Lounsbury +date: 2019-11-08 +affiliation: The Open Group +copyright: ©2019, The Open Group +--- # Getting Started with The Open Group Community GitLab Wiki @@ -6,20 +12,20 @@ ### Wiki Basics -What is a Wiki? -What is Markdown syntax? -Markdown editing tools -How to access the wiki on GitLab -How to create and edit a document -Reverting: How to revert your inevitable mistake +* What is a Wiki? +* What is Markdown syntax? +* Some Markdown editing tools +* How to access the wiki on GitLab +* How to create and edit a document +* Reverting: How to revert your inevitable mistake ## Resources -Where to find documentation and help -Some best practices on content +* Where to find documentation and help +* Some best practices on content ## Master class -AsciiDoc syntax -Conversion of existing materials -Diagramming in Wikis \ No newline at end of file +* AsciiDoc syntax +* Conversion of existing materials +* Diagramming in Wikis \ No newline at end of file diff --git a/source/what_is_Wiki.md b/source/what_is_Wiki.md new file mode 100644 index 0000000000000000000000000000000000000000..b3f061082b003b028a92ee51b1fcce23beaeae48 --- /dev/null +++ b/source/what_is_Wiki.md @@ -0,0 +1,35 @@ +--- +title: What is a Wiki? +author: David Lounsbury +date: 2019-11-08 +affiliation: The Open Group +copyright: ©2019, The Open Group +--- + +# What is a Wiki? + + +## Wiki Overview + +From [Wikipedia](https://en.wikipedia.org/wiki/Wiki): + +> A wiki is a knowledge base website on which users collaboratively modify content and structure directly from the web browser. In a typical wiki, text is written using a simplified markup language and often edited with the help of a rich-text editor + +The defining characteristics: + +* Collaborative editing of content + * Any user with access can create and edit content +* Direct availability of edited content on the web + +Caveats: + +* Many types of wikis in the world +* Different wiki implementations use different markup languages +* Different wiki implementations have different editing interfaces + +## Wikis on Gitlab + +* GitLab provides a built-in Wiki for each project +* GitLab wikis can use Markdown, AsciiDoc, or Rdoc markup language + * Either Markdown or AsciiDoc syntax are recommended +* Gitlab can be edited either through the web interface of by editing and committing files \ No newline at end of file