Mark down seems like a no-brainer, except for the fact that once we are done the doc needs to go back into Kantara format which can take a long time with approvals and everything. Both Google and GitHub support markdown. Google docs in comment mode seems to work best for me. You can write out in md or word, which helps somewhat since the final version needs to be in word for Kantara. This process is why i personally abandoned Kantara for creating documents. Peace ..tom jones On Tue, Sep 1, 2026 at 8:38 AM John Wunderlich via Wg-pemc < wg-pemc@kantarainitiative.org> wrote:
Folks,
I wanted to send this ahead of tomorrow’s call because I want to ensure we are on the same page with respect to drafting and editing for v1.1 (and eventually v2.0). Right now, I'm juggling a few tools, and I don’t think any one of them is doing the whole job well. I think we have three options, all with different sets of problems. Sadly, the problems are likely to be even worse if we don't land on one of the options.
*Option 1: Confluence:* This is already home base for the Work Group. Kantara hosts it, our meeting notes and votes live there, and everyone already has a login. No new tool to learn. The catch: Confluence just isn’t built for real collaborative drafting. Formatting gets clunky fast, tracking who changed what is awkward, and editing a long document with several people in it at once is not what it’s good at.
*Option 2: Google Docs:* Google is genuinely good at the thing Confluence is bad at: real-time collaborative writing. Comments, suggestions, and multiple people typing at once are all functional. The catch: it depends on each of us keeping track of our own Google Doc links and sharing permissions. Links go stale, sharing settings get missed, and someone’s always asking, “Wait, which doc is the current one?”
*Option 3: GitHub:* GitHub solves the link problem: one repository, one address, always up to date, and it works whether you’re inside or outside a Google account. It also gives us a clean, dated record of who wrote what and when, which is genuinely useful for our IPR obligations under the Non-Assertion Covenant. The catch: it has a learning curve. If you’ve never used GitHub, the idea of commits, branches, and pull requests can feel like a lot just to leave a comment on a document.
Full disclosure: I’m personally partial to Markdown writing, mostly because I already write these drafts in Markdown on my own machine, so it fits how I work. But that should not be a determinative factor for the group.
Have a think so you can express your preference (or your objections) to tomorrow’s call or in a reply to this email.
Have a better than expected day, John Wunderlich
“The law, in its majestic equality, forbids rich and poor alike to sleep under bridges, to beg in the streets, and to steal their bread.”
― Anatole France
Calendly: https://calendly.com/privacycdn LinkedIn: https://www.linkedin.com/in/privacycdn/ Bluesky: https://bsky.app/profile/privacycdn.bsky.social Mastodon: https://mastodon.social/@PrivacyCDN Twitter: https://twitter.com/PrivacyCDN
This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited. _______________________________________________ A Community Group mailing list of KantaraInitiative.org Wg-pemc mailing list -- wg-pemc@kantarainitiative.org To unsubscribe send an email to staff@kantarainitiative.org List archives -- https://mailman.kantarainitiative.org/hyperkitty/list/wg-pemc@kantarainitiat... ______ Group wiki -- https://kantara.atlassian.net/wiki/spaces/Wg-pemc