Add EE docs

[Andersson007]

This PR moves the files created in https://github.com/ansible/community-docs/pull/60/files.

Fixes ansible-community/community-team#243

[oraNod]

@Andersson007 I pushed a commit directly to your branch to get the structure as agreed at the docs meeting.

I also made a few edits and dropped the "terminology" section because I don't think it's that useful. TBH I found the terminology was a little confusing. Also I would assume people understand concepts like container runtimes and it's not the job of Ansible documentation to explain them.

[oraNod]

LGTM

[Andersson007]

@samccann could you please take a look?

[samccann]

give a writer a second chance to look at a file, and she'll find more things to comment on :-)

[Andersson007]

@samccann all feedback is incorporated, PTAL

[samccann]

Thanks. I'd like core approval first since this PR currrently adds the EE getting started guide to core docs as well.

[Andersson007]

Thanks. I'd like core approval first since this PR currrently adds the EE getting started guide to core docs as well.

@sivel @nitzmahone PTAL #18 (comment)

This PR's waiting for your approval to get merged

[oraNod]

@Andersson007 I added the orphan tag to suppress the toc-tree warning from sphinx. This is necessary if the index is not included in the main core index.

My vote is still on publishing this on devel only and discussing where to create more "ecosystem" docs.

In a previous comment I mentioned a separate ansible/ecosystem-documentation repo but additional repositories increases contributor overhead. I think a potential solution might be a structure in ansible/ansible-documentation like this:

docs/
├─ core/
│  ├─ rst/
│  │  ├─ index.rst
├─ ecosystem/
│  ├─ rst/
│  │  ├─ index.rst
├─ package/
│  ├─ rst/
│  │  ├─ index.rst

[samccann]

I think y'all are waiting on me for this one. Thanks for removing this from the core docs. There's one other step to take. Basically, anything 'excluded' from core (and the japanese core translation) means you also need to add any new files to the exclude section in the conf.py files:
https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/sphinx_conf/core_conf.py#L93
and
https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/sphinx_conf/core_lang_conf.py#L93

Or those two docsets will no longer build :-)

[Andersson007]

I think y'all are waiting on me for this one. Thanks for removing this from the core docs. There's one other step to take. Basically, anything 'excluded' from core (and the japanese core translation) means you also need to add any new files to the exclude section in the conf.py files: https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/sphinx_conf/core_conf.py#L93 and https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/sphinx_conf/core_lang_conf.py#L93

Or those two docsets will no longer build :-)

@samccann done, thanks, PTAL

[oraNod]

Discussed this one at the docs (DaWGs) meeting today (July 11, 2023). Agreement is to merge and keep this on the devel branch of the Ansible package docs until we establish an official home for the ecosystem docs. The layout that I suggested for ansible/ansible-documentation seems to be preferred over another, separate, docs repo. We'll see how that shakes out.

[oraNod]

Thank you @Andersson007 Big +1 to all the work here. 🎉 🌮 🐙

[Andersson007]

thanks everyone for your great help! Would've been impossible this to look as good as it's now without you!