chore(docs): remove obsolete TODO and placeholder comments

[thetaPC]

Issue URL: N/A

What is the current behavior?

Five commented-out notes are scattered through the docs, left as reminders to come back and write something later. Two are section stubs in datetime-button.md, one is a block in item.md describing a CSS variable, one asks whether the CLI help section needs a screenshot, and two are placeholders where a table of contents used to be generated inline.

All five have been overtaken by changes elsewhere, so none of them describe work that still needs doing.

What is the new behavior?

Removes the five notes from the current docs and their v7 copies. These are MDX comments, so nothing changes in the rendered pages.

Each was checked against its current replacement before removal:

• item.md described enabling the detail arrow on md items with --item-detail-push-show. That variable no longer exists in the framework. The detail property does this now, and the prose directly above the comment already documents it.
• datetime-button.md had empty Customization, Buttons, and Theming stubs. The component exposes one CSS shadow part and no custom properties, both already listed by the auto-generated tables on the page.
• cli.md asked whether to add an image of the --help output. That output is generated as real text under docs/cli/commands/, which stays current as the CLI changes. A static image would go stale, would not be translatable or searchable, and would contradict the note above it explaining that help output differs per project type.
• versioning.md and what-are-progressive-web-apps.md had TOC goes here placeholders from the pre-Docusaurus generator. Docusaurus renders the table of contents in the sidebar, and neither page sets hide_table_of_contents.

Does this introduce a breaking change?

• Yes
• No

Other information

N/A

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ionic-docs	Ready	Preview	Aug 12, 2026 9:36pm