Getting Started As A Contributor

Welcome to the AgileMe wiki.

Here are some notes on how to get started and contribute to the wiki:

Intent

The mission for the wiki is to provide an open and accessible repository of agile knowledge for all agilists, coaches, scrum masters, product owners, leaders and practitioners.

The content ranges from articles, workshop facilitation guides, illustrations and much more, all available under a Creative Commons Attribution Share Alike International License

Getting a Login

If you don't already know me (Dave) then use the Contact Us form to get in touch or use the Gentle Agile Folk slack channel to request a new login.

Once created the login will allow you to create new pages and edit existing ones.

Rules

There are only two rules:

1. If you can't find a page, create one
2. If you do find a page, correct it

Writing A New Article

Creating A New Page

It can be frustrating to want to get started and not see how to create a new page. There are two ways to do this:

1. Enter your page title in the search bar and the results page will show a red link to the page name, click on the link and then you should be able to edit your new page
2. Embed a link into an existing page and when you next read the page it will show the link as a red link. Click on the red link and then you should be in an edit window for that page

Categories

Each page should be linked to a category and the convention at the moment is to put a category as the very first line of the page when in edit mode.

Categories are like lists of pages and so adding a new page to a category immediately means it is not an orphaned page and can be found in a category.

Multiple categories can be added e.g. if a page is a scrum related article then we might like to add it to the Agile, Agile:Articles and Agile:Scrum categories, and it can then be searched under each of those categories.

Common categories include:

• Agile Articles - insert [[Category:Agile:Articles]] into your page
• Scrum - insert [[Category:Agile:Scrum]] into your page
• Kanban - insert [[Category:Agile:Kanban]] into your page
• eXtreme Programming (XP) - insert [[Category:Agile:XP]] into your page
• Agile Tools - insert [[Category:Agile:Tools]] into your page
• Agile Workshops - insert [[Category:Agile:Workshops]] into your page
• Agile Presentations - insert [[Category:Agile:Presentations]] into your page
• Agile Coaching - insert [[Category:Agile:Coaching]] into your page
• Agile Training - insert [[Category:Agile:Training]] into your page
• Agile Culture - insert [[Category:Agile:Culture]] into your page
• Agile Leadership - insert [[Category:Agile:Leadership]] into your page
• Agile Conferences - insert [[Category:Agile:Conferences]] into your page
• Agile Everything - insert [[Category:Agile]] into your page

Headers

Headers are quite easy:

• Big Header type in =Header=
• Sub Header type in ==Header==
• Sub Sub Header type in ===Header===

Bold and Italic

• For bold text type in '''Bold Text Here'''
• For italic text type in ''Italic Text Here''

Links

It's quite easy to add links into a page and the following are two methods:

1. For a link to another page use [[Page Title]]
2. For a link to an external site use [http://mysite.com Caption]

Files

Use the "Upload" file link on the nav bar (left hand side) to upload files. (A maximum file size is limited to 32 Mb.)

Once a file is uploaded you can then embed a link to the file in your article in the following ways:

• Ordinary link to the file use [[:File:MyFile.pdf|Link Text Here]]
• Want to have a direct link to a downloadable file e.g.a pdf use [[Media:MyFile.pdf|Link Text Here]]
• Want to display a picture on the page use [[File:MyPicture.jpg|500px|Caption Here]]
• Want to display a pdf doc on the page use <pdf width="300" height="500">MyFile.pdf</pdf>

For more info on files check out Wikimedia Images

Tables

Tables are a bit long winded but to get the following table:

Header #1	Header #2
Item #1	Item #2
Item #3	Item #4

Type in the following:

{| class="wikitable"

!Header #1

!Header #2

|-

|Item #1

|Item #2

|-

|Item #3

|Item #4

|}

For more info on tables check out Wikimedia Tables

See Also

It is really good to add in a "See Also" footer to your pages as this is where links to related docs can be found and is really helpful for a reader to navigate and find your contributions

References

Remember that the site content is under a Creative Commons license, so if you want attribution to your work, then pay it back by also providing attribution and citations to work that you have referenced.

This also shows where you got your ideas from, provides some legitimacy to the work and allows a further reading on the subject for the reader.