<div dir="ltr">I wonder; would it be possible to make the website inline editable and then it automatically creates github pull requests that update the docs in github as D comments?</div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jan 7, 2016 at 8:30 AM, Rory McGuire <span dir="ltr"><<a href="mailto:rjmcguire@gmail.com" target="_blank">rjmcguire@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div class="h5"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Jan 6, 2016 at 10:01 PM, Martin Nowak via Digitalmars-d-announce <span dir="ltr"><<a href="mailto:digitalmars-d-announce@puremagic.com" target="_blank">digitalmars-d-announce@puremagic.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span>On Wednesday, 6 January 2016 at 15:41:29 UTC, Adam D. Ruppe wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
I know projects get bugs open when they are used, but ddox is a one-person project and that one person doesn't seem terribly active in it.<br>
</blockquote>
<br></span>
I'm another user of ddox and fix things when they annoy me.<br>
I don't have many problems with it though.<br>
It you'd joined we'd already be 3.<br>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<a href="https://github.com/rejectedsoftware/ddox/graphs/contributors" rel="noreferrer" target="_blank">https://github.com/rejectedsoftware/ddox/graphs/contributors</a><br>
</blockquote>
<br>
The main reasons why work has stalled is that the future of dpl-docs is unclear. Instead of fixing the remaining issues w/ ddox people have spend a huge amount of time to improve ddoc output, so b/c of this weird course Söhnke stopped working on dpl-docs for now.<br>
The other reason is that the existing tool already does most things you want from a documentation system. The styling sucked so I wrote scod, but most of the remaining issues are minor problems that will eventually be addressed. And even if you don't agree w/ some aspect of it, working on a common documentation engine/library makes more sense than having everyone write it's own, in particular if you're arguing about limited time.<br>
</blockquote></div><br></div></div></div><div class="gmail_extra">I like our current documentation. The only real barrier to entry for non D devs is the weird symbols names we've used for the standard library. They are good names, but they are "sciency". It would be great if people could "tag" symbols in the current documentation website. That way anyone could put things like "go:Dial" in the tags for Socket's "@safe this(Address connectTo);" and "js:contains" in the tags for canFind(). All the symbols in std.algorithm.setops could use some less "sciency" tags.<br></div><div class="gmail_extra"><br></div><div class="gmail_extra">If not a tagging system then at least adding synonyms would be great.</div><div class="gmail_extra"><br></div><div class="gmail_extra">The documentation on Google Developers is excellent for api discovery, our docs are quite similar I think. (In our company even sales and lead gen use the Google Developers docs to check if something is possible.</div><div class="gmail_extra"><br></div></div>
</blockquote></div><br></div>