[Notes] [Git][BuildGrid/buildgrid][finn/99-faq] Adding an FAQ to the docs.



Title: GitLab

finn pushed to branch finn/99-faq at BuildGrid / buildgrid

Commits:

2 changed files:

Changes:

  • README.rst
    1
    -
    
    2 1
     .. _about:
    
    3 2
     
    
    4 3
     About
    
    ... ... @@ -14,7 +13,7 @@ BuildGrid is a Python remote execution service which implements Google's
    14 13
     `Remote Execution API`_ and the `Remote Workers API`_. The project's goal is to
    
    15 14
     be able to execute build jobs remotely on a grid of computers in order to
    
    16 15
     massively speed up build times. Workers on the grid should be able to run with
    
    17
    -different environments. It is designed to work with clients such as `Bazel`_ and 
    
    16
    +different environments. It is designed to work with clients such as `Bazel`_ and
    
    18 17
     `BuildStream`_.
    
    19 18
     
    
    20 19
     .. _Remote Execution API: https://github.com/bazelbuild/remote-apis
    
    ... ... @@ -46,6 +45,7 @@ Resources
    46 45
     - `Bug tracking`_
    
    47 46
     - `Mailing list`_
    
    48 47
     - `Slack channel`_ [`invite link`_]
    
    48
    +- `FAQ`_
    
    49 49
     
    
    50 50
     .. _Homepage: https://buildgrid.build
    
    51 51
     .. _GitLab repository: https://gitlab.com/BuildGrid/buildgrid
    
    ... ... @@ -53,3 +53,4 @@ Resources
    53 53
     .. _Mailing list: https://lists.buildgrid.build/cgi-bin/mailman/listinfo/buildgrid
    
    54 54
     .. _Slack channel: https://buildteamworld.slack.com/messages/CC9MKC203
    
    55 55
     .. _invite link: https://join.slack.com/t/buildteamworld/shared_invite/enQtMzkxNzE0MDMyMDY1LTRmZmM1OWE0OTFkMGE1YjU5Njc4ODEzYjc0MGMyOTM5ZTQ5MmE2YTQ1MzQwZDc5MWNhODY1ZmRkZTE4YjFhNjU
    
    56
    +.. _FAQ: https://buildgrid.gitlab.io/buildgrid/faq.html

  • docs/source/faq.rst
    1
    +.. _faq:
    
    2
    +
    
    3
    +FAQ
    
    4
    +===
    
    5
    +
    
    6
    +Q. Which clients are currently supported?
    
    7
    +R. Currently we support `BuildStream`_, `Bazel`_ and `RECC`_. Though any client which implements v2 of the Remote Execution API should be supported.
    
    8
    +
    
    9
    +Q. Where can I get the most up to date information?
    
    10
    +R. We have a `mailing list`_ you can sign up to and a `slack channel`_ you can join.
    
    11
    +
    
    12
    +Q. Can I have feature XYZ?
    
    13
    +R. Perhaps, let's have a chat first. Check that a similar issue hasn't been raised already and then `raise`_ one yourself if it hasn't. From there we can discuss the feature.
    
    14
    +
    
    15
    +Q. I've made a cool thing, can I have it in BuildGrid?
    
    16
    +R. Again, perhaps. We would encourage you to raise an issue or contact the mailing list first to make everyone aware of your idea. Then, create a `merge request`_. The worst we can do is politely decline your work, otherwise you're now officially a contributor! Have a quick read of the `contributing`_ guidelines before making your patch submission.
    
    17
    +
    
    18
    +Q. Help! This thing isn't working!?!
    
    19
    +R. Please `raise`_ an issue or ask us on the `slack channel`_ for some help.
    
    20
    +
    
    21
    +Q. How do I install BuildGrid?
    
    22
    +R. Check out this `installation page`_.
    
    23
    +
    
    24
    +Q. How do I check on the status of a job?
    
    25
    +R. Using the command line tool you can simply list all the current jobs and select one for the status
    
    26
    +
    
    27
    +    .. code-block:: sh
    
    28
    +
    
    29
    +       bgd operation list
    
    30
    +       bgd operatation status <insert-operation-id>
    
    31
    +
    
    32
    +Q. How does CAS expiry work?
    
    33
    +R. We are working hard on automatic CAS expiry but until we have that, we recommend you regularly clean the CAS folder yourself.
    
    34
    +
    
    35
    +.. _BuildStream: https://buildstream.build
    
    36
    +.. _Bazel: https://bazel.build/
    
    37
    +.. _RECC: https://gitlab.com/bloomberg/recc
    
    38
    +.. _mailing list: https://lists.buildgrid.build/cgi-bin/mailman/listinfo/buildgrid
    
    39
    +.. _slack channel: https://join.slack.com/t/buildteamworld/shared_invite/enQtMzkxNzE0MDMyMDY1LTRmZmM1OWE0OTFkMGE1YjU5Njc4ODEzYjc0MGMyOTM5ZTQ5MmE2YTQ1MzQwZDc5MWNhODY1ZmRkZTE4YjFhNjU
    
    40
    +.. _merge request: https://gitlab.com/BuildGrid/buildgrid/merge_requests
    
    41
    +.. _contributing: https://gitlab.com/BuildGrid/buildgrid/blob/master/CONTRIBUTING.rst
    
    42
    +.. _raise: https://gitlab.com/BuildGrid/buildgrid/issues
    
    43
    +.. _installation page: https://buildgrid.gitlab.io/buildgrid/installation.html



  • [Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]