AgGateway Wiki Usage & Tips /JIRA
Navigate
spaces
Spaces are created by Member Services.
Contact Member Services if you feel a new space needs to be set up
search
This is the magnifying glass on the tool bar (not the gray search bar in the toolbar above). Used to search for words or replace word(s)
page hierarchy
Find this in the breadcrumbs - provides the location within a hierarchy the page you're on is located.
breadcrumbs
Use the breadcrumbs to copy, move, delete, export the page to Word or PDF, import documents; manage permission restrictions on the page; obtain the page link that follows it no matter what the name of the page is; review the page history, attachments, hierarchy and attachments.
sidebar
Sidebar can be collapse or expanded by the arrows on the bottom of the sidebar
Can be configured (if you have authority) the sidebar for Page Tree or Child Pages (suggest Child Pages)
Provides a listing (hierarchy) of the page and any child pages of the page you are on
toolbars
There are a number of toolbars, depending on where you are in the page. You can hover over an icon to find out what the icon is for or use the drop-down arrows.
watch
You can identify what spaces or pages you watch - when changes are made and the "notify watchers" is checked, you will be notified of the changes to the page via email. You click on the "watching" icon (that looks like an eye) to manage what you want to watch within that space.
Create Pages
"Create" button
Creates a page as a child to the page you are currently on (and space)
Templates
Templates can be imported (typically done by the administrators) so that they can be used when a "create" page is selected.
Copy page
Using the breadcrumbs, you can copy a page and rename it to set up a new page
When you copy, and save with a new page title, you are creating a new page in that space - so if you are using a format from another committee or council, be sure that after you save the new page, that you use "Move" to transfer that new document to the correct space for the committee or council.
Word import
To import a word document, you should NOT be in edit mode. Click on the breadcrumbs (...) and select "Import Word Document", then follow the direction and determine how you want to import.
Edit Pages
Headings
When editing a heading, you are changing the page name
If you use a link by copying the URL bar, that could change if the heading is changed. Use the breadcrumbs to "Link to Page" to copy the internal page link (it will not change even if you change the heading)
Referencing users
To reference someone that is a wiki user, use the "@" and start typing their name (such as "@Jim Wilson" will show up as @Jim Wilson which will link to that person's contact information)
Specifying dates
To specify a date use "//" and a calendar will pop up so you can choose the date. Click on the date and it will put it in your document (they appear as Sep 15, 2016 )
Specifying tasks
On the toolbar, there a box with a checkbox in it. When you click on it it creates a task (that can be assigned to someone (shown in front of this comment). Examples of a task items below:
Tables
Creating
Create a table by clicking on the table icon in the task bar. Determine the number of rows and columns by highlighting the size. You can always add or delete rows or columns
Adding, deleting, copying, moving rows
To modify the rows, when you are in the table, a toolbar comes up for the table and the row icons to add (either above or below), delete, copy, move the rows
Adding, deleting, copying, moving columns
Like the rows, there are also icons to add (either left or right of column you are on), delete, copy, or move the columns
Row headers
On the table toolbar, there is an icon with the top row in gray. Click on it will create that row as a header and will not be considered for row numbers.
Column headers
Like the row headers, there is an icon with the first column is gray. Click on it will create that column as a header.
Row numbers
Using the table task bar, click on the setting icon (looks like a gear), and select insert row numbers). This will insert row numbers on all rows that are NOT headers.
Links
Other pages
You can link other pages, but clicking on the "link" icon (looks like a paperclip). Choose either to find the page by searching for it, or most recently viewed - then find your page and click "insert".
Websites
See instructions to the "other pages", but when you get to the options, click on "web link", locate the website and click insert.
Attachments
See instructions to the "other pages", but when you get to the options, click on "files", locate the file you want to attach and click on insert
Sections
You will need to click on the page layout icon (looks like 2 columns or text), This will provide an additional toolbar. You can ad a section by clicking on the + Add Section. You can delete or move the section using this toolbar, as well as determine how many columns you want in the section.
Share Pages
Linking
To share a link to a page, you can either copy the URL address, or go to the breadcrumbs Share button and click on "copy link" at the bottom of the pop up menu, then the permanent link to the page will be copied to your clipboard. Caution: The URL address can change if you change the title of the document, but the "share → copy link" does not change - so it is best to use this link rather than the URL address.
URL in address bar
See note above in "Linking"
Export to Word or PDF
To export a page to Word or PDF document - click on the breadcrumb (...) and then click on Export and select “Export to Word" or "Export to PDF" from the pop out menu.
Terminology
Atlassian
the company that developed Confluence and JIRA Software (and others), and offers it them as services as part of Atlassian Cloud
Atlassian is an Australian company.
Confluence
a set of web pages with a style more suited for documentation/operations than marketing.
a collaborative content-development environment.
in an AgGateway context, it's "the wiki"
a companion application to JIRA (single sign-on)
JIRA
a project-oriented task-management tool
a companion application to Confluence (single sign-on)
project
a set of related tasks in JIRA
every task in JIRA must be associated with a project
space
a collection of related wiki (Confluence) pages
a space may have permissions assigned to it distinct from other spaces
wiki
Key Concepts
AgGateway's Atlassian Cloud service includes:
Confluence ("the wiki")
The wiki is composed of spaces.
Spaces are composed of pages and each space has a root page.1
Pages can have child pages. (Conversely, all pages except root pages have a single parent page.)
Pages can have attachments
JIRA Software ("JIRA"–don't know why it's in all caps)
JIRA is composes of projects.
Projects are composed of tasks.
1Technically a space may have more than one root page, but that situation is rare, is not obvious to accomplish, and is not important to the wiki user when such a situation exists (i.e., the user wouldn't know about it or care if they did know about it).