Background
As I see the increasing use of shared code repository tools for document management, I'm also starting to look at the different markup languages available to us and in common use. This page holds some of my notes on the topic.
Andrew Hughes, Leadership Council Chair, 2016-09-12
Code repository services
| Name | Home URL | Info and reviews | Comparison articles | Works well with... |
|---|---|---|---|---|
| github | https://gist.github.com/foogit/8410710 https://www.upguard.com/articles/github-vs-bitbucket
| |||
| BitBucket | https://www.atlassian.com/software/bitbucket/comparison/bitbucket-vs-github https://www.process.st/bitbucket-vs-github-version-control-software/ | Atlassian Confluence, JIRA |
Markup Languages suitable for Kantara purposes
Note: I don't have a bias towards/against any markup language here. So if there is an imbalance in positive v negative review links it is not intentional.
| Name | Home URL | Info and reviews | Comparison articles | Works well with... |
|---|---|---|---|---|
| Markdown | http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/ | http://hyperpolyglot.org/lightweight-markup | ||
| AsciiDoc | http://asciidoctor.org/docs/what-is-asciidoc/ | http://hyperpolyglot.org/lightweight-markup | ||
| reStructuredText (RST) | https://en.wikipedia.org/wiki/ReStructuredText
| http://hyperpolyglot.org/lightweight-markup | Python  |
Historical Posts from meetings and email reflectors
| Link | Comment |
|---|---|
| UMA telecon 2010-07-01 | use of github is authorized |
| http://kantarainitiative.org/pipermail/lc/2015-July/002699.html | "Proposal for discussion: Tool chain for Connected Life specs" |
| UMA telecon 2015-08-27 | Maciej's XSLT for XML2RFC -> Kantara spec format |
Page attachments
