Closed tiffany-taylor closed 3 years ago
This change is only a small improvement to the instructions: those instructions would be much better off being reviewed and amended as a whole rather than making isolated "improvements" (the SVN to Git changes are a perfect example of what not to do).
@tiffany-taylor - would you be willing to spend some more time on that?
Issues that would remain, to name a but few:
doc-base
!
doc-base
and en
from SVN. However, the conversion to the Git command messed this up, and you're now building on top of that./tmp
is the "root directory" or workspace for the instructions, so why not just put phd
, en
, doc-base
, etc. directly under /tmp
?doc-base
as mentioned above/tmp/git/doc-en/mydocs/php-web/
is mentioned, which won't exist.My suggestions for this page:
I'll step through it tomorrow and give an attempt at rewriting it.
The reasoning for this change is so that it's easier to start working with the docs with fresh clones from github.
doc-base/configure.php
expects anen
directory, but if I clonedoc-en
repo from github, I have adoc-en
directory with manual contents in thedoc-en
folder. This requires further renaming and directory juggling to get the tooling to work together nicely. By cloning intodoc-en/en
, this leaves adoc-en
base directory that can containen
for thedoc-en
repo,phd
anddoc-base
, then the rest of the tutorial instructions work nicely.