I agree with Cyrus that Confluence page should a good place for that since, seems, it will be very dev oriented documentation.
> On 7 Aug 2019, at 16:31, Cyrus Maden <cma...@google.com> wrote: > > Hi Łukasz, > > This sounds perfect for the confluence, since we already have the testing > guide > <https://cwiki.apache.org/confluence/display/BEAM/Contribution+Testing+Guide> > in there. There's already a link to the testing guide in the > beam.apache.org/contribute <http://beam.apache.org/contribute> section, which > might help direct folks to the new doc as well. > > Best, > Cyrus > > On Wed, Aug 7, 2019 at 7:54 AM Łukasz Gajowy <lgaj...@apache.org > <mailto:lgaj...@apache.org>> wrote: > Hi all, > > I'm currently working on documenting the load tests of Core Apache Beam > operations > <https://docs.google.com/document/d/1PuIQv4v06eosKKwT76u7S6IP88AnXhTf870Rcj1AHt4/edit#> > as we have some Jenkins jobs running and several dashboards for that. > > This is what I've got so far (work in progress but comments are welcome): > LINK > <https://docs.google.com/document/d/1t41vGO7uWdeV0P-v8dTlKUSwshpuZHn0_rvjo-MPcs4/edit?usp=sharing> > > I've got the following doubts on where I should put it: > the tests are rather dev-facing. Should the documentation for them be on the > beam.apache.org <http://beam.apache.org/> page (where the user-facing > documentation is located) or maybe only on Beam's confluence? > if that belongs to confluence only, should I simply place it under > "technical/design docs" section? > if this goes on the website, what is the best place to put it? > What are your thoughts? > > Thanks, > Łukasz