[seven] - Rearrange docs

[sneridagh]

@stevepiercy moved the docs to the root, amend a bit index.md.

Take a look maybe I overlooked something.

Again, why don't we do this in main?

[stevepiercy]

Do what exactly to main? You did two major things:

• Promoted documentation from docs/source to docs
• Started writing docs for Seven

plone/documentation pulls in plone/volto:main and publishes it at 6.docs.plone.org as official docs.

I'm fine with moving the docs up a directory. That's not a big deal. We'll need to fiddle with submodules, symlinks, and paths.

I don't understand pulling in Seven modifications for publishing at 6.docs.plone.org at this time, unless you want to thoroughly confuse active Volto users.

[sneridagh]

@stevepiercy I was refering to remove the "source" directory in main :)
Obviously, the changes in the index are only for this branch. Did you realise this is targeted to the 7 branch, right?

[stevepiercy]

Yes, but your question was ambiguous.

[stevepiercy]

And as far as changing the location of volto docs on its main branch, it's merely scratching an itch for no benefit from busy work in documentation. I've got too many higher priorities to take this on.

[stevepiercy]

I have a couple of questions.

I wordsmithed the Rationale section, removing tones of exasperation and frustration, while adding deliberate and sensible direction.

After merging this, can you please rename this branch to seven? I'm sorry, but this really messes with me, because numerical branches are usually reserved for version number tags. It also is hard to search for, as RTD demonstrated.

[stevepiercy]

Is this a symlink? GitHub's UI doesn't indicate what this is.

[sneridagh]

I think it's a mistake or a leftover? It shoud have been inside my sources folder for some reason...

[sneridagh]

ok, there was an ignore for that, probably it's something done by some sync script.

[sneridagh]

@stevepiercy ready.

[stevepiercy]

Delete docs/_build and everthing else within. Make sure it is in .gitignore correctly.

[stevepiercy]

You committed this directory, but should not have done so.

[stevepiercy]

Do we really want to say "by the community"? I might remove it.

Suggested change

	The codename is _temporary_, the final name of the product has to be decided in the future, by the community when the release happens.
	The codename is _temporary_, the final name of the product will be chosen by the community when the release happens.

[stevepiercy]

Suggested change

	It is under active development [in its own branch `seven`](https://github.com/plone/volto/tree/seven) in parallel with Volto in the `main` branch and current stable branch `18.x.x`.
	It is under active development [in its own branch `seven`](https://github.com/plone/volto/tree/seven) in parallel with both Volto 19 in the branch `main` and the current stable version Volto 18 in the branch `18.x.x`.

[stevepiercy]

Suggested change

	- {doc}`plone:contributing/index` is for people who have not yet signed the Plone Contributor Agreement or contributed to any other project under the GitHub Plone organization, including Volto.
	- {doc}`plone:contributing/index` is for all people who want to contribute code to any projects under the Plone GitHub organization, including Volto.

[stevepiercy]

Almost forgot this one.

[stevepiercy]

Suggested change

	The Seven user interface (UI) is a React-based frontend for [Plone](https://plone.org).
	The Seven user interface (UI) is a fast, elegant, and intuitive React-based frontend for [Plone](https://plone.org).