This wiki is for the IETF Community - any IETF participant is welcome to edit it.
This page covers the mechanics of how to contribute. When making contributions, please be aware these guidelines for content on wiki.ietf.org about what to contribute.
NOTE: To contribute to this wiki you must first log in (icon in the upper right corner) using your Datatracker credentials.
Once you are logged in, you can create or edit pages on this wiki. Only administrators can delete pages, create private pages, and add custom CSS/scripts to pages.
All pages are written in the WikiJS flavour of Markdown.
Please aim for a consistent style as follows:
Generally, this is one of the following forms:
/group/{{group acronym}}/{{additional structure}}/{{page name}}
/meeting/{{meeting number}}//{{additional structure}}/{{page name}}
The wiki product we are using has the following known limitations:
If you want to try out the new wiki platform without creating a page of your own, there's a sandbox to play in.
You can edit a page in one of two ways:
Some online tools ease the initial creation of tables in Markdown (Table generator; for copy/paste from spreadsheets).
TIP: If you are editing a very long page then you can turn off live rendering to speed up page editing, with the split screen icon above the live render.
To create a page, you use the new Page icon in the upper right. If you cannot see it then you are not logged in.
The first question you are asked is to provide a path for the page - please see the Page and path naming convention above.
Then you are asked what Editor type you want to use - please choose a new Markdown page not one of the other types (code, wysiwyg, etc).
Finally you are asked for a title for the page. Please make this consistent with the page name you chose earlier.
If you need to add an image or other asset (PDF) for your wiki, you can do that by using the "Insert Asset" folder icon in the left side of the editor view. From there you will be prompted to browse for the file to upload. After uploading, you will be able to perform various actions on the asset using the '...' link in the Action column of the asset list.
If you are responsible for content on an existing IETF wiki there are a number of resources available to help transition content from an existing Wiki.
If you are an IETF or IRTF group chair and would like to initial help or additional information about transitioning your group's wiki to this platform, please contact: support@ietf.org.
Quick start
If a page doesn't already exist for your group, you can create it by simply navigating to:
https://wiki.ietf.org/group/{{group acronym}}e.g., the main wiki page for the the 6man Working Group is at https://wiki.ietf.org/group/6man
When linking to subpage from a group page, you can use the syntax:
[link text](page_name)
e.g. the markdown for linking to the main IDR page at https://wiki.ietf.org/group/idr to the subpage at https://wiki.ietf.org/group/idr/idr-draft-status looks like:[idr-draft-status](idr-draft-status)
If you are an IETF or IRTF group chair and would like additional information about transitioning your group's wiki to this platform, please contact: support@ietf.org.
If you have responsibility for any active IETF-related wiki (e.g. working group or directorate wiki), and are looking to get help or a head start on moving content, you are encouraged to participate in the next content sprint, which is open to anyone who wants a focused time to work on and get help with setting up content at wiki.ietf.org, covering topics such as:
Hybrid Content-o-thon on 5 November during IETF 115
This hybrid content-sprint will take place from 1400-1800 GMT on 5 November in the Mezzanine 9 room.
The wiki is bi-directionally mirrored with a GitHub repository, which you are welcome to clone.
As noted above, pull requests are accepted against the repository, though initially direct editing is preferred. Any change made directly on Wiki.js becomes a commit (attributed to your email) on GitHub.