Re: Contributing a new how-to to the EPICS web site

[Ralph Lange via Tech-talk <tech-talk at aps.anl.gov>]

That's work in progress. I understand your confusion.

On Mon, 6 Apr 2020 at 17:37, Mark Rivers <rivers at cars.uchicago.edu> wrote:

I am now totally confused.
There is a Windows installation guide here:

https://epics-controls.org/resources-and-support/documents/howto-documents/installation-windows/

The old one, converted ~2018 from the document on the old APS EPICS web site. This is a real content on the epics-controls.org WordPress site.

That appears not to be built from this:

https://github.com/epics-docs/how-tos/blob/master/getting-started/installation-windows.rst

Correct. That's a new guide that Hitesh recently contributed to the GitHub repo.

which appears to be published here:

https://docs.epics-controls.org/projects/how-tos/en/latest/getting-started/installation-windows.html

Because everything under docs.epics-controls.org is the generated output of the new How-To setup, generated from the GitHub repo, hosted on ReadTheDocs.

The two Windows installation documents describe completely different approaches.

Yes. Both valid, but quite different.

From the top-level of https://epics-controls.org/ I can easily click my way down to this:

https://epics-controls.org/resources-and-support/documents/howto-documents.

Because it's part of the same web site (a WordPress instance).

 

But can I click my way down to this?

https://docs.epics-controls.org/projects/how-tos/en/latest/

Because proper linking from the epics-controls site to the newly added ReadTheDocs pages is the part of the job where manpower and time at the Documentathon were not enough to finish it.

Sorry for the state of the project, I hope this explains the situation a bit better,
~Ralph