======================================================================
#ansible-docs: Documentation Working Group supplemental - docsit split
======================================================================


Meeting started by samccann at 15:30:40 UTC. The full logs are available
at
https://meetbot.fedoraproject.org/ansible-docs/2020-12-10/documentation_working_group_supplemental_-_docsit_split.2020-12-10-15.30.log.html
.



Meeting summary
---------------
* opening chatter  (samccann, 15:30:51)
  * LINK: https://github.com/ansible/ansible/pull/72287   (dmsimard,
    15:37:24)
  * here is a WIP for "ansible --version" to display both the
    ansible-core and ansible versions
    https://github.com/ansible/ansible/pull/72287  (samccann, 15:37:43)
  * ACTION: samccann acozine - ask for a way to show the Ansible version
    along with core version installed  (samccann, 15:44:54)
  * can use a combination of ansible --version (to show core version
    once the pr is merged) and pip show ansible for the Ansible version
    (samccann, 15:46:25)
  * will need  a page or paragraph somewhere that says "here's how you
    tell which versions you have installed"  (samccann, 15:48:40)
  * symlinks likely will be bad for SEO but generating two versions of
    the docsite from the same sources could work (along with other
    limitations)  (abadger1999, 15:57:16)
  * Known things that would have to change  to maintain good SEO with
    duplicate content are the /latest/ url and canonical url which is
    specified in the conf.py  (abadger1999, 15:58:08)
  * AGREED: We will duplicate user guide on Ansible docs and
    ansible-core docs with appropriate SEO optimizations  (samccann,
    16:01:10)
  * ACTION: samccann to ask internal SEO expert how to handle duplicat
    content - is cannonical url enough?  (samccann, 16:01:32)

* moving ansible-core docs to a new docsite  (samccann, 16:01:48)
  * ACTION: samccann to discuss ansible-core having its own docsite w/
    core team  (samccann, 16:05:45)

* ansible-core docs with no collection index  (samccann, 16:07:51)
  * while it is not ideal that you can't find anything about
    networking/cloud/security on the ansible-core docsite, this is an
    short-term fix until we get to a docsite based on personas and a
    better way to get between all the information  (samccann, 16:13:58)

* moving non-plugin collections docs to other repo(s)  (samccann,
  16:14:53)
  * see the section here for an overview -
    https://hackmd.io/iDEyihLqRtWnjtOUd3pNYQ  (samccann, 16:15:06)
  * and see here for some real detail -
    https://hackmd.io/pPeMLaFYSt2W8RAqm-ZkXA  (samccann, 16:15:27)

* where do we publish ansible.builtin docs  (samccann, 16:16:49)
  * we need to track ansible version as 3.X since it will be one docset
    to cover 3.0, 3.1, etc (aka semver)  (samccann, 16:36:41)
  * can we have `ansible-3.x', `ansible-core-3.0`, etc in the version
    dropdowns so we have one docsite with both sets of info?  (samccann,
    16:39:27)
  * ACTION: samccann to create better mockups of separate /ansible/ vs
    /ansible-core docsites for review  (samccann, 17:03:09)
  * LINK: https://docs.ansible.com/ansible/devel/collections/index.html
    (acozine, 17:10:06)
  * we will need separate conf.py to do all this... tho might be done w/
    builder instead of different repos. Intersphinx might help with M()
    between the docsites some  (samccann, 17:21:31)
  * need something on ansible-core collection index to say 'go to
    ansible for  much more'  (samccann, 17:29:52)
  * ACTION: acozine to create a PR with a page about "figuring out
    versions"  (acozine, 17:45:02)
  * ACTION: samccan to hack more mockups, maybe play w/ intersphinx
    (samccann, 17:46:41)

Meeting ended at 17:48:13 UTC.




Action Items
------------
* samccann acozine - ask for a way to show the Ansible version along
  with core version installed
* samccann to ask internal SEO expert how to handle duplicat content -
  is cannonical url enough?
* samccann to discuss ansible-core having its own docsite w/ core team
* samccann to create better mockups of separate /ansible/ vs
  /ansible-core docsites for review
* acozine to create a PR with a page about "figuring out versions"
* samccan to hack more mockups, maybe play w/ intersphinx




Action Items, by person
-----------------------
* acozine
  * samccann acozine - ask for a way to show the Ansible version along
    with core version installed
  * acozine to create a PR with a page about "figuring out versions"
* samccann
  * samccann acozine - ask for a way to show the Ansible version along
    with core version installed
  * samccann to ask internal SEO expert how to handle duplicat content -
    is cannonical url enough?
  * samccann to discuss ansible-core having its own docsite w/ core team
  * samccann to create better mockups of separate /ansible/ vs
    /ansible-core docsites for review
* **UNASSIGNED**
  * samccan to hack more mockups, maybe play w/ intersphinx




People Present (lines said)
---------------------------
* samccann (180)
* acozine (98)
* abadger1999 (97)
* sivel (66)
* felixfontein (44)
* zodbot (12)
* dmsimard (9)
* dericcrago (9)
* lmodemal (1)




Generated by `MeetBot`_ 0.1.4

.. _`MeetBot`: http://wiki.debian.org/MeetBot