chore: move to exclude only logic

[StaticRocket]

• chore: move to exclude only logic based on toc.txt

  Exclude all documents with an rst suffix not explicitly listed in the toc.txt.
  This removes a lot of dead logic and unnecessary config values.

  For a while this project mixed including and excluding document logic, where
  the include list was provided as an exhaustive description of everything
  through the toc.txt and a basic exclude list was provided as a sparse array
  populated manually in the OS tags.py file.

  This sparse array was supposed to change the way we searched for index files
  (previously referred to as toctreefiles), but ultimately any index files we
  needed were already listed in the main toc.txt.

  Signed-off-by: Randolph Sapp [email protected]

Closes #167

[StaticRocket]

I've tested this change locally against all DEVFAMILY and OS combinations. It resulted in no difference.

[StaticRocket]

The next logical change will be another PR, where I remove that string concatenation to add the file extension back in and manipulate all the TOC files to include extensions.

[cshilwant]

+ @jsuhaas22 @jeevantelukula @sadik-smd for reviews

[jeevantelukula]

@StaticRocket
WARNING: toctree contains reference to nonexisting document 'linux/Overview_Software_Stack' [toc.not_readable]

Getting these warnings when referencing all toc trees. Hope these will be taken care in your follow up PR

[StaticRocket]

That's expected. It's reducing the logic but moving a chunk of the previously suppressed toc.excluded warnings to toc.not_readable.

I suppose that does overload the toc.not_readable warning though, as now it can signify that the file doesn't exist OR it's intentionally ignored. Hmm. Maybe we do want to keep the include+exclude logic so error filtering is a little easier. Let me think about this a bit.

[StaticRocket]

Moved to exclude only logic as this preserves the current warning behavior. Slightly updated to clean up more of the old *.py file comments around the old exclude_patterns list.

[jeevantelukula]

LGTM