aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/rule-challenges.md
Commit message (Collapse)AuthorAge
* Tweak the grammar of some titles in bazel documentation.Gravatar ahumesky2017-12-08
| | | | | RELNOTES: None. PiperOrigin-RevId: 178406494
* Use relative paths in links in docs.Gravatar dzc2017-06-26
| | | | | | | | | | | | | | | | This change fixes links among Bazel docs to use relative paths links instead of absolute path (either full URL or absolute from site root). This way, versioned documentation will link to other pages within the same versioned directory rather than to the site root, which will point to the latest version of the page from HEAD. Future improvements may include adding a lint tool to check links in documentation to ensure that the correct convention is followed such that all links to pages within a version of the docs will point to pages within the same version. RELNOTES: None PiperOrigin-RevId: 160117865
* Restructure site/ directory into docs/ which only contains Bazel documentation.Gravatar dzc2017-06-01
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The new docs/ directory in the bazel source tree will only contain the Bazel docs site, which is hosted at docs.bazel.build. This change deletes the marketing site and blog, which have been migrated to the bazel-website and bazel-blog GitHub repositories respectively. This change also updates the serve-docs.sh and ci/build.sh under scripts/ in preparation for publishing the docs site. Note that to help make reviews more manageable, this change is limited to moving files to their new locations. Here are the follow-up changes: * Update all links in docs to remove versions/master in paths and to add correct bazel.build subdomain when linking to pages on the marketing site or the blog. * Set up versioned directories on GCS bucket and add tooling for versioning docs This change is also coordinated with https://bazel-review.googlesource.com/c/11568/ to have the PublishSite job publish to docs.bazel.build rather than www.bazel.build. Issue #2397 RELNOTES: None PiperOrigin-RevId: 157612651
* Replace doc pages with redirects to versioned doc pages.Gravatar David Chen2016-08-29
| | | | | | | | | | | | | | * Add a new `redirect` Jekyll layout. * Replace all pages under docs/ with redirects to corresponding page under versions/master/. * Prepend links on Documentation sidebar, including generated navs for the Skylark Library and Build Encyclopedia, with prefix for versioned directory. * Add code to both the internal jekyll-config.sh and external jekyll-tree.sh to add redirect pages for the Skylark Library and Build Encyclopedia. * Bring the branched User Manual doc up to date with latest changes. -- MOS_MIGRATED_REVID=131568800
* Rewords the rules pitfall documentGravatar Damien Martin-Guillerez2016-08-05
So it stop suggesting that it is hard to write rules, though it is not easy to write good rules :) -- MOS_MIGRATED_REVID=129423968