Migration documentation

[nilshempelmann]

Time to brush up the documentation.

@Zeitsperre @tlvu: I suggest to move this chapter on components to the top level documentation

This: https://birdhouse-deploy.readthedocs.io/en/latest/birdhouse/components/README.html
to here: https://birdhouse2-docs.readthedocs.io/en/latest/list_apps/

Probably also the highlevel descriotion of deployment would be fitting into the toplevel documentation

Any thoughts?

[tlvu]

@nilshempelmann
By "move" do you mean put a link or a reference at the new place to point to the old place?

It's much easier for us to keep the doc in the same repo as the code so when we perform code change we also update the docs at the same time.

[nilshempelmann]

@tlvu : The Top-level birdhouse Documentation is now starting with the introduction of the different components: https://birdhouse2-docs.readthedocs.io/en/latest/
Which I think is the right place.

How to align with https://birdhouse-deploy.readthedocs.io/en/latest/birdhouse/components/README.html

[tlvu]

The Top-level birdhouse Documentation is now starting with the introduction of the different components: https://birdhouse2-docs.readthedocs.io/en/latest/

@nilshempelmann
This is what I see at https://birdhouse2-docs.readthedocs.io/en/latest/, the components are not listed.

Do you mean here https://birdhouse2-docs.readthedocs.io/en/latest/apps/ ?

How to align with https://birdhouse-deploy.readthedocs.io/en/latest/birdhouse/components/README.html

The list of components at https://birdhouse-deploy.readthedocs.io/en/latest/birdhouse/components/README.html also includes house-keeping components like the scheduler or monitoring. I think we should only mention WPS services?

So I think keep keeping a duplicate list as it is at https://birdhouse2-docs.readthedocs.io/en/latest/apps/ is fine. The name and description of services do not change that often, a duplicate list is fine.

If you think it's useful, we can simply indicate next to each service how they be deployed (meaning from the PAVICS docker-compose stack or from Ansible). Some services, might have both. This allows the user the choice.

Also the PAVICS or DACCS stack (DACCS is just a continuation of PAVICS) is federated here https://marbleclimate.com/node.html. So if someone starts a new node, if would be useful for them to join the federation.

Where do you suggest we mention this federation?

[nilshempelmann]

Yes right, the list of birds is not longer at the start page ;-).

Agree, that a doublication of components is fine and makes sence, since the two lists follow different logics.

I added the initiatives in the current PR where Pavics, Daccs is mentioned. Marple can be added there as well and other initiatives I am not aware of.