Transparency-Accountability/Wiki-Style-Guide: Difference between revisions
No edit summary |
|||
| Line 10: | Line 10: | ||
===Page Creation=== | ===Page Creation=== | ||
To create a page in the [[Transparency-Accountability]] portion of the wiki, you must search for a non-existant page. All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions. The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link. | To create a page in the [[Transparency-Accountability]] portion of the wiki, you must search for a non-existant page. All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions. The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link. | ||
===Naming Conventions=== | |||
There are three important conventions when naming pages | |||
# Begin the page name with '''Transparency-Accountability/''' | |||
#*The slash in the page name appears in the url like a directory, and Transparency-Accountability indicates our groups' "ownership" of the page | |||
# Use dashes rather than spaces to separate words in page names | |||
#* Spaces appear as underscores in links and urls such as with [[Main_Page]]. The dashes create more attractive and intuitive urls and internal links | |||
# Try to minimize the number of words in the page name. The longer the page name, the longer the url. A good example is '''[[Transparency-Accountability/Minutes]]''', where Minutes was chosen over Meeting-Minutes. | |||
Revision as of 17:56, 13 December 2018
Wiki Style Guide, Editing Standards and Tips
Wiki Ownership
Keep in mind that the wiki belongs to the Digital Library Federation proper. The left-hand menus direct users to resources of the broader organization rather than the Government Records Transparency and Accountability Interest Group portion of the wiki.
For instance, the DLF logo to the upper left of every wiki page is linked to the DLF wiki homepage: Main_Page
Government Records Transparency and Accountability Interest Group Homepage
The effective wiki homepage for the Government Records Transparency and Accountability Interest Group is Transparency-Accountability. The 'external' url of this page, https://wiki.diglib.org/Transparency-Accountability is inextricably linked to the decision to name the page Transparency-Accountability. The choice of page names and resulting urls are directly linked, and therefore page naming conventions are useful in creating attractive and logical urls.
Page Creation and Naming Conventions
Page Creation
To create a page in the Transparency-Accountability portion of the wiki, you must search for a non-existant page. All pages should include Transparency-Accountability/ in their names as is explained below in the section on Page Naming Conventions. The wiki, upon a search that fails to locate a page with a searched for name, will allow the user to create a page with that name by providing a link.
Naming Conventions
There are three important conventions when naming pages
- Begin the page name with Transparency-Accountability/
- The slash in the page name appears in the url like a directory, and Transparency-Accountability indicates our groups' "ownership" of the page
- Use dashes rather than spaces to separate words in page names
- Spaces appear as underscores in links and urls such as with Main_Page. The dashes create more attractive and intuitive urls and internal links
- Try to minimize the number of words in the page name. The longer the page name, the longer the url. A good example is Transparency-Accountability/Minutes, where Minutes was chosen over Meeting-Minutes.