aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/designs
Commit message (Collapse)AuthorAge
* 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
* Document declared providers.Gravatar Dmitry Lomov2017-04-25
| | | | | Change-Id: Ifdc1773fb1439c16327bb84961998793a942e666 PiperOrigin-RevId: 154151084
* Edits to make list of design documents consistent.Gravatar Googler2017-04-06
| | | | PiperOrigin-RevId: 152256071
* It must to be clear to readers that design documents in the 'Contribute!' ↵Gravatar Googler2017-04-04
| | | | | | section do not describe current functionality of Bazel. If a reader comes to one of these pages from an online search, it must be clear that this is not documentation. PiperOrigin-RevId: 152052655
* Link documentation to "Specifying environment variables for actions" design doc.Gravatar Googler2017-03-27
| | | | | | | | Fix #2730 -- PiperOrigin-RevId: 151116555 MOS_MIGRATED_REVID=151116555
* Add the label_keyed_string_dict design doc to Bazel's site.Gravatar Michael Staib2017-03-07
| | | | | | -- PiperOrigin-RevId: 149319159 MOS_MIGRATED_REVID=149319159
* Design Docs: Add a section to the Sandboxing 2.0 Doc on what files a ↵Gravatar Philipp Wollermann2017-02-28
| | | | | | | | sandboxed process should have access to. -- PiperOrigin-RevId: 148758110 MOS_MIGRATED_REVID=148758110
* Set status of design doc on repository invalidation to implemented.Gravatar Damien Martin-Guillerez2017-02-15
| | | | | | | | -- Change-Id: I026cde47338a2adbe3907e22192ec4b490ad8fea Reviewed-on: https://cr.bazel.build/8221 PiperOrigin-RevId: 147579412 MOS_MIGRATED_REVID=147579412
* Fix the images in the recursive WS design docGravatar Kristina Chodorow2017-01-30
| | | | | | | | | | | Somehow they were all uploaded as 0 bytes, but that's okay because the URLs in the design doc were wrong, anyway. Relavant design doc: https://bazel.build/designs/2016/09/19/recursive-ws-parsing.html, issue #1943. -- PiperOrigin-RevId: 145799866 MOS_MIGRATED_REVID=145799866
* Skylark repository invalidation design doc update Gravatar Damien Martin-Guillerez2017-01-10
| | | | | | | | | | | | | | 1. Set status to implementing 2. Reorder the list of tasks because we need to invalidate correctly Skylark repositories before enabling environ parameter. 3. Fix the step 2 (was step 3) in order to pass a map instead of creating a new function. -- Change-Id: I9387ccedf75d63fef7e2e9546dc1f0421cb12679 Reviewed-on: https://cr.bazel.build/7972 PiperOrigin-RevId: 143999391 MOS_MIGRATED_REVID=143999391
* Mark distribution artefact design document as implementedGravatar Klaus Aehlig2016-11-30
| | | | | | | -- Change-Id: I080c6b32cd0b206b176700dad8b6e1ce799856ae Reviewed-on: https://cr.bazel.build/7537 MOS_MIGRATED_REVID=140578960
* Add a design doc on how to invalidate (Skylark) remote repositoriesGravatar Damien Martin-Guillerez2016-11-21
| | | | | | | -- Change-Id: I86660a0101261b42a06bb94afe0bc9f0bc5e5528 Reviewed-on: https://cr.bazel.build/6697 MOS_MIGRATED_REVID=139574326
* Change our URL to bazel.buildGravatar Damien Martin-Guillerez2016-10-28
| | | | | -- MOS_MIGRATED_REVID=137500893
* Global cleanup change.Gravatar Damien Martin-Guillerez2016-10-28
| | | | | -- MOS_MIGRATED_REVID=137494506
* Add design doc for recursive WORKSPACE file parsingGravatar Kristina Chodorow2016-10-14
| | | | | | | | | #1943 -- Change-Id: Ic7b4378acb4d3661a1b61ff887c9cc8592df9f7e Reviewed-on: https://bazel-review.googlesource.com/c/6131/ MOS_MIGRATED_REVID=136154990
* Add a design document on a distribution artifact for bazelGravatar Klaus Aehlig2016-10-12
| | | | | | | | | | | | | | | | | | With bazel sources depending on checked-in binaries for the supported platforms, porting bazel to a new platform is hard; that approach also doesn't scale well if we want to support users on more platforms. This design document suggests an alternative approach based on creating a zip-archive that, besides all sources, also contains the generated output of the protoc actions. From this archive, bazel can be bootstrapped without depending on the right protoc on the target platform. -- Change-Id: I401452435ed4189ea95260961d981ccc99a98560 Reviewed-on: https://bazel-review.googlesource.com/#/c/6530 MOS_MIGRATED_REVID=135891242
* Fix typo in 2015-03-06-bazel-init.mdGravatar is03wlei2016-10-10
| | | | | | | | Closes #1915. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1915 MOS_MIGRATED_REVID=135676413
* Update environment design documentGravatar Klaus Aehlig2016-10-07
| | | | | | | | | | | - Instead of a script for freezing the client environment, an info key was added. - Mark as implemented. -- Change-Id: I1928031bbe535fef2ffdedba4485fa9a37f4c1ec Reviewed-on: https://bazel-review.googlesource.com/#/c/6494 MOS_MIGRATED_REVID=135356539
* Rollback of commit c5545fd0896f3c602a9be0986debed6f0c9c662d.Gravatar Klaus Aehlig2016-09-30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | *** Reason for rollback *** Roll-forward with appropriate fixes: --action_env is a "build" option, not a "common" option. Moreover, also inherit the corresponding variables for tests from the effective action environment. Also fix the corresponding error in the design document. *** Original change description *** Automated [] rollback of commit 96d46280bc5a4803ba2242a4ad16939f85a3b212. *** Reason for rollback *** Broke installation on latest release. Fixes #1846 *** Original change description *** Reintroduce .bazelrc and set --action_env defaults Shipping a .bazelrc was removed in 009b48bcfaf4ebb17f9ab03bea9036cfa3c12ff0. However, as per our "Specifying environment variables for actions" design document, we want to ship a global rc file specifying the common environment variables to be inherited. So revert that change and add the desired entries to the global bazelrc file we're shipping. *** -- MOS_MIGRATED_REVID=134769063
* Mark Sandboxing 2.0 design doc as launched on bazel.io.Gravatar Philipp Wollermann2016-09-13
| | | | | -- MOS_MIGRATED_REVID=132971817
* Added design doc about building python on WindowsGravatar Yun Peng2016-09-06
| | | | | -- MOS_MIGRATED_REVID=132257620
* Adding 'Implementing Beautiful Error Messages' design doc.Gravatar Elena-Irina Iancu2016-08-08
| | | | | | | -- Change-Id: I58686bc87be725041e98ed738890e7b0c7294a3b Reviewed-on: https://bazel-review.googlesource.com/#/c/4261/ MOS_MIGRATED_REVID=129616564
* Adds 'Beautiful Error Messages' design doc.Gravatar Pedro Liberal Fernandez2016-08-08
| | | | | | | -- Change-Id: Id626d41b0af9861a0e79022dcb48cffaa8c12e3a Reviewed-on: https://bazel-review.googlesource.com/#/c/4260/4 MOS_MIGRATED_REVID=129458423
* Added a design document and fixed linksGravatar Vladimir Moskva2016-08-08
| | | | | | | -- Change-Id: I1a904d19e1a63eff8c245bac3c18eb4ce9838912 Reviewed-on: https://bazel-review.googlesource.com/#/c/4271/ MOS_MIGRATED_REVID=129451413
* Adding a necessary header to the documentation fileGravatar Vladimir Moskva2016-08-05
| | | | | -- MOS_MIGRATED_REVID=129436348
* Updating the index file for design proposalsGravatar Vladimir Moskva2016-08-05
| | | | | -- MOS_MIGRATED_REVID=129432777
* Add 'Extensibility For Native Rules' design docGravatar Marcel Hlopko2016-08-05
| | | | | | -- Reviewed-on: https://bazel-review.googlesource.com/#/c/4250/5 MOS_MIGRATED_REVID=129431153
* Adding a design document about Declared ProvidersGravatar Vladimir Moskva2016-08-05
| | | | | -- MOS_MIGRATED_REVID=129426286
* Fix links to Skylark design stuff.Gravatar Dmitry Lomov2016-08-03
| | | | | -- MOS_MIGRATED_REVID=129217657
* Public version of Skylark Design Process.Gravatar Dmitry Lomov2016-08-02
| | | | | -- MOS_MIGRATED_REVID=129092214
* Add Skylark Remote Repositories design docs to the website.Gravatar Damien Martin-Guillerez2016-08-02
| | | | | | | | | | | | The original docs are at bazel init (removed doc) Skylark Remote Repositories: https://docs.google.com/document/d/1jKbNXOVp2T1zJD_iRnVr8k5D0xZKgO8blMVDlXOksJg/ Generating C++ crosstool with a Skylark Remote Repository: https://docs.google.com/document/d/1Ju74cmBCfYl8SEZT_tXhRmbi49ZLMzXgoQzzqve-dxI -- Change-Id: I5acb28c08c0de552c259e091249e8787c2cf0e58 Reviewed-on: https://bazel-review.googlesource.com/4222 MOS_MIGRATED_REVID=129078523
* Move Skyframe page from doc/ to designs/.Gravatar David Chen2016-07-29
| | | | | -- MOS_MIGRATED_REVID=128793556
* Move designs/ directory out of docs/ and into site root.Gravatar David Chen2016-07-29
For versioning Bazel's documentation, we only want to version the pages under the Documentation portion of the site. Since Design Docs are more meant for Bazel developers and are generally not continually updated for each release, we should not version the design docs. Moving the directory for the design docs out of docs/ will also simplify the change for versioning Bazel's docs. -- MOS_MIGRATED_REVID=128788588