Some minor documentation additions

[merriam]

I have only used Textual for a about a week, and would like to make a few documentation additions:

1. Mention more source examples. Expand the Example Code paragraph on the first page of the guide to mention the doc/examples trees, and the specific directories in the beginning of the Widgets, Containers, and Actions pages.
2. Fix minor typos as I run across them again.
3. Add two sentences to Visibility and Display pages explaining how they are different, and that they take different parameters.
4. Add noters to Label and Static explaining they are similar outside of CSS styling.
5. Add better explanation of datafile's sort, clarifying what exactly is sent in the column parameters.
6. Mention how DataTables move_row(1) gives a starting cursor and that row numbers start at 1.
7. Mention that there is currently no filter() style functionality; it is often searched for.
8. Mention or add an example where a table is quickly displayed without a cursor (show_cursor(False)) for a simple reactive display.
9. Mention DataTable meaning of "selected" and "highlighted" records.
10. Clarify various zebra-stripes references to talk about .datatable--even-row style.
11. Add a FAQ section about debugging Textual Apps with PyCharm and Visual Studio.
12. Add sample of using ccs_tree() function and better documentation.

My thought is to just write up what I can, each section as a separate commit in a PR, and submit. Any thoughts?

Item 1 was in PR #4673 but was rejected. Will consider additional wording and incorporate into a better paragraph.
Items 5, 6, 7, 8, 9, and 10 were merged in PR #4706.

[github-actions[bot]]

We found the following entry in the FAQ which you may find helpful:

• How do I pass arguments to an app?

Feel free to close this issue if you found an answer in the FAQ. Otherwise, please give us a little time to review.

This is an automated reply, generated by FAQtory

[merriam]

Seriously, has anyone ever closed an issue from FAQtory? Ever?

[davep]

Seriously, has anyone ever closed an issue from FAQtory? Ever?

Yeah, a few times actually.

[willmcgugan]

Documentation PRs are welcome.

[merriam]

Still need to add it to the relevant files. I'm traveling, so my side projects are going slow. :)

Here's the verbiage for a set of them. Any comments are appreciated as it is faster to incorporate comments in the draft than in the source files and final markdown formatting. Also, I will break it into appropriately sized PRs.

1. Mention more source examples. Expand the Example Code paragraph on the first page of the guide to mention the doc/examples trees, and the specific directories in the beginning of the Widgets, Containers, and Actions pages.

https://textual.textualize.io/guide/

(after) Most of the code in this guide is fully working—you could cut and paste it if you wanted to.
Although it is probably easier to check out the Textual repository and navigate to the docs/examples/guide directory and run the examples from there.

(add) The tree of directories under docs/examples contains of hundreds of examples for all parts of Textual. There are also complete applications in Textual's examples/ directory.

https://textual.textualize.io/getting_started/

(after) With the repository cloned, navigate to the /examples/ directory where you will find a number of Python files you can run from the command line:

cd textual/examples/

python code_browser.py ../

Also, the tree of directories under docs/examples contains of hundreds of examples for all parts of Textual

https://textual.textualize.io/widget_gallery/

(After) Welcome to the Textual widget gallery.
We have many more widgets planned, or you can build your own.

(add) Most of the code demonstrating each widget is fully working—you could cut and paste it if you wanted to.
Although it is probably easier to check out the Textual repository and navigate to the docs/examples/widgets directory and run the examples from there. The tree of directories under docs/examples contains of hundreds of examples for all parts of Textual. There are also complete applications in Textual's examples/ directory.

[merriam]

2. Fix minor typos as I run across them again.

The most common issue is mixing British American Spellings ("Labelled", "Colour") and American English Spellings ("Labeled", "Color"). Unfortunately, some of these have worked their way into various tests and sample code:

./tests/snapshot_tests/snapshot_report_template.jinja2:                     aria-labelledby="environmentModalLabel"
./docs/guide/testing.md:The following app shows three buttons labelled "red", "green", and "blue".
./docs/guide/testing.md:5. Simulates clicking on the widget with an `id` of `red` (the button labelled "Red").
./docs/widgets/data_table.md:### Labelled rows
./docs/widgets/data_table.md:=== "Labelled rows"
Binary file ./src/textual/widgets/__pycache__/_data_table.cpython-312.pyc matches
./src/textual/widgets/_data_table.py:        self._labelled_row_exists = False
./src/textual/widgets/_data_table.py:                self._labelled_row_exists = True
./src/textual/widgets/_data_table.py:        self._labelled_row_exists = False
./src/textual/widgets/_data_table.py:        return self._labelled_row_exists and self.show_row_labels
./src/textual/widgets/_data_table.py:        if self._labelled_row_exists and self.show_row_labels:
./src/textual/widgets/_tabs.py:    class Relabelled(TabMessage):
./src/textual/widgets/_tabs.py:        """A tab was relabelled."""
./src/textual/widgets/_tabs.py:        self.post_message(self.Relabelled(self))
./src/textual/widgets/_tabs.py:    def _on_tab_relabelled(self, event: Tab.Relabelled) -> None:
./src/textual/widgets/_tabs.py:        """Redraw the highlight when tab is relabelled."""

I could open a bug and PR to fix these, though it seems like a small nit. It might be worthwhile to mention somewhere prefering American over British spellings (as LabeledBox is already in the public API).

[merriam]

Item changes:

1. Mention more source examples. Expand the Example Code paragraph on the first page of the guide to mention the doc/examples trees, and the specific directories in the beginning of the Widgets, Containers, and Actions pages.

_Created pull request #4673 Just handling Widgets, Getting Started, and Guide _

2. Fix minor typos as I run across them again.

Morphed into trying to fix British spellings and is extremely low priority

12. Create better documentation and example of DomNode.tree(), with an example. (new)