> Why not double-down on the GitHub wiki? It's very easy to learn to use, > and there are edit buttons everywhere so there is no "distance" between > the docs and the ability to edit them. The easier it is to edit docs, > the better we'll do at keeping them up to date. > > I like Markdown, and am OK with editing Markdown files wherever they > live, but it's not very likely that I would install Swift and figure > out how to build a new project to to see what the result looks like. > With GitHub, we can easily preview results live to ensure we're not > messing anything up. Also, Markdown is not the only format supported by GitHub. It's also possible to use AsciiDoc, POD, reStructuredText, or any other format listed in [1] in any file of main repository or in wiki, and it will be rendered to HTML when browsing online. [1] https://github.com/github/markup/blob/master/README.md#markups -- Regards, Konstantin _______________________________________________ webkit-dev mailing list webkit-dev@lists.webkit.org https://lists.webkit.org/mailman/listinfo/webkit-dev
Re: [webkit-dev] WebKit Documentation
Konstantin Tokarev via webkit-dev Tue, 20 Sep 2022 01:32:05 -0700
- [webkit-dev] WebKit Documentation Brandon Stewart via webkit-dev
- Re: [webkit-dev] WebKit Documentati... Michael Catanzaro via webkit-dev
- Re: [webkit-dev] WebKit Documen... Ryosuke Niwa via webkit-dev
- Re: [webkit-dev] WebKit Documen... Konstantin Tokarev via webkit-dev
- Re: [webkit-dev] WebKit Documentati... Fujii Hironori via webkit-dev
- Re: [webkit-dev] WebKit Documen... Ling Ho via webkit-dev
- Re: [webkit-dev] WebKit Documen... Ryosuke Niwa via webkit-dev
- Re: [webkit-dev] WebKit Documentati... Ryosuke Niwa via webkit-dev
- Re: [webkit-dev] WebKit Documen... Michael Catanzaro via webkit-dev
- Re: [webkit-dev] WebKit Doc... Ryosuke Niwa via webkit-dev
- Re: [webkit-dev] WebKit Documen... Brent Fulgham via webkit-dev
- Re: [webkit-dev] WebKit Doc... Ryosuke Niwa via webkit-dev
- Re: [webkit-dev] WebKit... Michael Catanzaro via webkit-dev
- Re: [webkit-dev] W... Ryosuke Niwa via webkit-dev