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

[Mark Rivers via Tech-talk <tech-talk at aps.anl.gov>]

Hi Ralph,

 

Thanks for the explanation, I understand.

 

I have added the documentation that Martin suggested to epics-docs and created a pull request:

 

https://github.com/epics-docs/how-tos/pull/2

 

Thanks,

Mark

 

 

From: Tech-talk <tech-talk-bounces at aps.anl.gov> On Behalf Of Ralph Lange via Tech-talk
Sent: Monday, April 6, 2020 10:59 AM
To: EPICS Tech Talk <tech-talk at aps.anl.gov>
Subject: Re: Contributing a new how-to to the EPICS web site

 

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