Re: Moving documentation to git
| From: | Dan Ackroyd | Date: | Sat, 08 Jul 2017 18:28:09 +0000 |
| Subject: | Re: Moving documentation to git | ||
| References: | 1 2 3 4 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386665@lists.php.net to get a copy of this message | ||
On 16 June 2017 at 16:44, Ben Ramsey <ben@benramsey.com> wrote:
>
> The purpose of edit.php.net is so that people can provide edits without
> needing to go through the documentation build process,
That's the theory. In practice edit.php.net is quite difficult to use.
For example the preview just does not work for me.
Reviewing commits is also a not entirely fun task in it.
> I think we’d still keep edit.php.net. We should try to address the
> accessibility issues it has.
Fixing it would be massive task. And possibly the wrong goal anyway.
People don't need to be able to edit stuff on a website - they need to
be able to see whether their changes:
i) Break the build.
ii) Look correct.
Neither of those things are related to an online editor - but are
related to automated builds and branches, the tools for which are much
more potent now than they were when the original docs were created.
cheers
Dan