| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
docs: improve navigation for functions doc pages (#4924) ## Changes Made The list of functions is moved from the sidebar to the table of contents. This is achieved via: 1. a custom plugin nav-hide-children which hides the functions in the nav 2. custom templates that use page metadata to override the default table of contents Screenshots: <img width="1593" height="1106" alt="image" src="https://github.com/user-attachments/assets/432b5844-146a-48dc-8f91-78fc4220d1e0" /> ## Related Issues Follow-up to #4838 ## Checklist - [x] Documented in API Docs (if applicable) - [x] Documented in User Guide (if applicable) - [x] If adding a new documentation page, doc is added to docs/mkdocs.yml navigation - [x] Documentation builds and is formatted properly (tag @/ccmao1130 for docs review) --------- Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> | 1 年前 | |
docs: add noindex tag to non-stable pages (#5105) ## Changes Made Adds noindex tag to all docs that are not /stable/ As per https://aioseo.com/docs/when-to-use-noindex-or-the-robots-txt/ > The biggest difference to understand is that if you want search engines to not include content in search results, then you MUST use the NOINDEX tag and you MUST allow search engines to crawl the content. If search engines CANNOT crawl the content then they CANNOT see the NOINDEX meta tag and therefore CANNOT exclude the content from search results. > > So if you want content not to be included in search results, then use NOINDEX. If you want to stop search engines crawling a directory on your server because it contains nothing they need to see, then use “Disallow” directive in your robots.txt file. i.e. we should: 1. Allow for crawling of all docs (fix robots.txt) NOTE: this is not done in this PR, see below for why 2. Add a canonical link for everything that is not stable NOTE: this is done already 3. Add a <noindex> tag for everything that is not stable This PR just does (3). This means that starting from 0.6.0, all versioned docs will have the noindex tag. However, it is not yet safe to modify our robots.txt because all docs <0.6.0 still do not contain noindex. We should only modify the robots.txt once we have that guarantee. ## Testing * Confirmed that <noindex> tag now appears in this build: https://getdaft-docs--5105.org.readthedocs.build/en/5105/quickstart/ * Previously not appearing in https://docs.daft.ai/en/v0.5.22/quickstart/ | 1 年前 |