Re: [Mesa-dev] Updating mesa3d.org docs?

2016-04-09 Thread Rhys Kidd 
On 9 April 2016 at 16:19, Brian Paul  wrote:

> On 04/09/2016 01:09 PM, Rhys Kidd wrote:
>
>> On Thursday, October 15, 2015, Brian Paul > > wrote:
>>
>> On 10/15/2015 01:18 PM, Sarah Sharp wrote:
>>
>> Hi Brian!
>>
>>
>> Hi Sarah,
>>
>>
>> I'm a new Mesa developer in Intel's OTC graphics team (although
>> not new
>> to open source, I've been a Linux kernel developer for the last
>> seven
>> years).
>>
>> I heard that you're responsible for updating mesa3d.org
>> <
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__mesa3d.org=BQMFaQ=Sqcl0Ez6M0X8aeM67LKIiDJAXVeAw-YihVMNtXt-uEs=T0t4QG7chq2ZwJo6wilkFznRSFy-8uDKartPGbomVj8=2U9kWir1cBYA05OdS3Zeeks1wPxuSOcnsf-ajjN8M3I=snUhIuiDJwuTupwNo_RzgVx0GbxOEnLhAKIG1XTBYjg=
>> >
>> documentation
>> against the docs in the Mesa source code repo. I noticed the
>> docs are
>> out-of-date WRT the repo, and I had a couple questions:
>>
>> 1. What's the process for pushing updated documentation to the
>> site?
>>
>>
>> All the website pages are found in the git docs/ directory.  Changes
>> are submitted as patches and reviewed like code on the mesa-dev list.
>>
>>
>> 2. How often are updated docs pushed? Once every week, month, or
>> when
>>  there's a new Mesa version?
>>
>>
>> I push them whenever a new Mesa version is released, but I can do it
>> at any time on request.
>>
>>
>> Hello Brian,
>>
>> Now that Mesa 11.2 has been released, could you please push the docs to
>> mesa3d.org
>>
>
> I did a few days ago, but I guess I missed the envvars.html file.  It's
> there now.
>

Thanks Brian.

<
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__mesa3d.org=BQMFaQ=Sqcl0Ez6M0X8aeM67LKIiDJAXVeAw-YihVMNtXt-uEs=T0t4QG7chq2ZwJo6wilkFznRSFy-8uDKartPGbomVj8=2U9kWir1cBYA05OdS3Zeeks1wPxuSOcnsf-ajjN8M3I=snUhIuiDJwuTupwNo_RzgVx0GbxOEnLhAKIG1XTBYjg=
>> >?
>>
>> A number of relevant changes, however my selfish interest is to see the
>> vc4 debug settings in envvars.html make the website. The number of vc4
>> users and developers running on the Mesa stack are increasing.
>>
>
> -Brian
>
>
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

Re: [Mesa-dev] Updating mesa3d.org docs?

2016-04-09 Thread Brian Paul 

On 04/09/2016 01:09 PM, Rhys Kidd wrote:

On Thursday, October 15, 2015, Brian Paul > wrote:

On 10/15/2015 01:18 PM, Sarah Sharp wrote:

Hi Brian!


Hi Sarah,


I'm a new Mesa developer in Intel's OTC graphics team (although
not new
to open source, I've been a Linux kernel developer for the last
seven
years).

I heard that you're responsible for updating mesa3d.org


documentation
against the docs in the Mesa source code repo. I noticed the
docs are
out-of-date WRT the repo, and I had a couple questions:

1. What's the process for pushing updated documentation to the site?


All the website pages are found in the git docs/ directory.  Changes
are submitted as patches and reviewed like code on the mesa-dev list.


2. How often are updated docs pushed? Once every week, month, or
when
 there's a new Mesa version?


I push them whenever a new Mesa version is released, but I can do it
at any time on request.


Hello Brian,

Now that Mesa 11.2 has been released, could you please push the docs to
mesa3d.org


I did a few days ago, but I guess I missed the envvars.html file.  It's 
there now.




?

A number of relevant changes, however my selfish interest is to see the
vc4 debug settings in envvars.html make the website. The number of vc4
users and developers running on the Mesa stack are increasing.


-Brian


___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

Re: [Mesa-dev] Updating mesa3d.org docs?

2016-04-09 Thread Rhys Kidd 
On Thursday, October 15, 2015, Brian Paul  wrote:

> On 10/15/2015 01:18 PM, Sarah Sharp wrote:
>
>> Hi Brian!
>>
>
> Hi Sarah,
>
>
> I'm a new Mesa developer in Intel's OTC graphics team (although not new
>> to open source, I've been a Linux kernel developer for the last seven
>> years).
>>
>> I heard that you're responsible for updating mesa3d.org documentation
>> against the docs in the Mesa source code repo. I noticed the docs are
>> out-of-date WRT the repo, and I had a couple questions:
>>
>> 1. What's the process for pushing updated documentation to the site?
>>
>
> All the website pages are found in the git docs/ directory.  Changes are
> submitted as patches and reviewed like code on the mesa-dev list.
>
>
> 2. How often are updated docs pushed? Once every week, month, or when
>> there's a new Mesa version?
>>
>
> I push them whenever a new Mesa version is released, but I can do it at
> any time on request.
>
>
Hello Brian,

Now that Mesa 11.2 has been released, could you please push the docs to
mesa3d.org?

A number of relevant changes, however my selfish interest is to see the vc4
debug settings in envvars.html make the website. The number of vc4 users
and developers running on the Mesa stack are increasing.

Thanks in advance,
Rhys

3. Any chance I could get permissions to push updated docs?  I'll be
>> improving Mesa documentation as part of my new job, and I would love
>> to be able to push myself once patches are accepted, rather than
>> having to ping you.
>>
>
> The typical deal is we wait until a person has some track record of
> producing good patches before giving git-write/push privileges.
>
> So, I'd suggest you make some changes/patches, post them to the mesa-dev
> list for review (others can push them for you initially), and then when
> you've got some history established you can file a request (via bugzilla)
> for git privileges.
>
> -Brian
>
> ___
> mesa-dev mailing list
> mesa-dev@lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/mesa-dev
>
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

Re: [Mesa-dev] Updating mesa3d.org docs?

2015-10-15 Thread Sarah Sharp 
On Thu, Oct 15, 2015 at 01:34:54PM -0600, Brian Paul wrote:
> On 10/15/2015 01:18 PM, Sarah Sharp wrote:
> >1. What's the process for pushing updated documentation to the site?
> 
> All the website pages are found in the git docs/ directory.  Changes are
> submitted as patches and reviewed like code on the mesa-dev list.

Sounds good.

> >2. How often are updated docs pushed? Once every week, month, or when
> >there's a new Mesa version?
> 
> I push them whenever a new Mesa version is released, but I can do it at any
> time on request.

Ok, great! I'll ping you when I get patches in.

However, I will note that the push process isn't working for some pages
on the website. 11.0.1 was released in September 2015 (when I would
expect you to do an update). You pushed a commit in 2013 to remove
references to CVS (commit dbbe108951 "docs: replace CVS with git"), but
that change is still not reflected here:

http://www.mesa3d.org/sourcedocs.html

Other pages that are out of sync with master include:

http://www.mesa3d.org/systems.html
http://www.mesa3d.org/license.html
http://www.mesa3d.org/install.html
http://www.mesa3d.org/envvars.html
http://www.mesa3d.org/osmesa.html
http://www.mesa3d.org/extensions.html

The license page seems particularly important to have up-to-date on the
website, since the text changed from "IN NO EVENT SHALL BRIAN PAUL BE
LIABLE" to "IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE".

Pages that people would generally check often (index.html,
relnotes.html) all seem to get updated. There are also less-frequently
updated pages like shading.html that are up-to-date. It's a bit of
a mystery to me why the other pages aren't being updated.

> >3. Any chance I could get permissions to push updated docs?  I'll be
> >improving Mesa documentation as part of my new job, and I would love
> >to be able to push myself once patches are accepted, rather than
> >having to ping you.
> 
> The typical deal is we wait until a person has some track record of
> producing good patches before giving git-write/push privileges.
> 
> So, I'd suggest you make some changes/patches, post them to the mesa-dev
> list for review (others can push them for you initially), and then when
> you've got some history established you can file a request (via bugzilla)
> for git privileges.

Completely understandable. I have done a couple of commits to Mesa and
piglit, and I do have git repo access under the username 'sarah'.
I haven't pushed my own branches yet, as the patches are still being
tested internally, but I will be having someone else to push my initial
patches after they get mailing list review. I understand if you want to
wait a while for me to prove myself before you grant me additional
trusted privileges. :)

Sarah Sharp
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev

Re: [Mesa-dev] Updating mesa3d.org docs?

2015-10-15 Thread Brian Paul 
On Thu, Oct 15, 2015 at 3:27 PM, Sarah Sharp 
wrote:

> On Thu, Oct 15, 2015 at 01:34:54PM -0600, Brian Paul wrote:
> > On 10/15/2015 01:18 PM, Sarah Sharp wrote:
> > >1. What's the process for pushing updated documentation to the site?
> >
> > All the website pages are found in the git docs/ directory.  Changes are
> > submitted as patches and reviewed like code on the mesa-dev list.
>
> Sounds good.
>
> > >2. How often are updated docs pushed? Once every week, month, or when
> > >there's a new Mesa version?
> >
> > I push them whenever a new Mesa version is released, but I can do it at
> any
> > time on request.
>
> Ok, great! I'll ping you when I get patches in.
>
> However, I will note that the push process isn't working for some pages
> on the website. 11.0.1 was released in September 2015 (when I would
> expect you to do an update). You pushed a commit in 2013 to remove
> references to CVS (commit dbbe108951 "docs: replace CVS with git"), but
> that change is still not reflected here:
>
> http://www.mesa3d.org/sourcedocs.html
>
> Other pages that are out of sync with master include:
>
> http://www.mesa3d.org/systems.html
> http://www.mesa3d.org/license.html
> http://www.mesa3d.org/install.html
> http://www.mesa3d.org/envvars.html
> http://www.mesa3d.org/osmesa.html
> http://www.mesa3d.org/extensions.html


OK, should be fixed now.



>
> The license page seems particularly important to have up-to-date on the
> website, since the text changed from "IN NO EVENT SHALL BRIAN PAUL BE
> LIABLE" to "IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
> LIABLE".
>
> Pages that people would generally check often (index.html,
> relnotes.html) all seem to get updated. There are also less-frequently
> updated pages like shading.html that are up-to-date. It's a bit of
> a mystery to me why the other pages aren't being updated.
>

Just an oversight.



>
> > >3. Any chance I could get permissions to push updated docs?  I'll be
> > >improving Mesa documentation as part of my new job, and I would love
> > >to be able to push myself once patches are accepted, rather than
> > >having to ping you.
> >
> > The typical deal is we wait until a person has some track record of
> > producing good patches before giving git-write/push privileges.
> >
> > So, I'd suggest you make some changes/patches, post them to the mesa-dev
> > list for review (others can push them for you initially), and then when
> > you've got some history established you can file a request (via bugzilla)
> > for git privileges.
>
> Completely understandable. I have done a couple of commits to Mesa and
> piglit, and I do have git repo access under the username 'sarah'.
> I haven't pushed my own branches yet, as the patches are still being
> tested internally, but I will be having someone else to push my initial
> patches after they get mailing list review. I understand if you want to
> wait a while for me to prove myself before you grant me additional
> trusted privileges. :)
>

Yeah, I'm sure it won't take you long...

-Brian
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev

Re: [Mesa-dev] Updating mesa3d.org docs?

2015-10-15 Thread Brian Paul 

On 10/15/2015 01:18 PM, Sarah Sharp wrote:

Hi Brian!


Hi Sarah,



I'm a new Mesa developer in Intel's OTC graphics team (although not new
to open source, I've been a Linux kernel developer for the last seven
years).

I heard that you're responsible for updating mesa3d.org documentation
against the docs in the Mesa source code repo. I noticed the docs are
out-of-date WRT the repo, and I had a couple questions:

1. What's the process for pushing updated documentation to the site?


All the website pages are found in the git docs/ directory.  Changes are 
submitted as patches and reviewed like code on the mesa-dev list.




2. How often are updated docs pushed? Once every week, month, or when
there's a new Mesa version?


I push them whenever a new Mesa version is released, but I can do it at 
any time on request.




3. Any chance I could get permissions to push updated docs?  I'll be
improving Mesa documentation as part of my new job, and I would love
to be able to push myself once patches are accepted, rather than
having to ping you.


The typical deal is we wait until a person has some track record of 
producing good patches before giving git-write/push privileges.


So, I'd suggest you make some changes/patches, post them to the mesa-dev 
list for review (others can push them for you initially), and then when 
you've got some history established you can file a request (via 
bugzilla) for git privileges.


-Brian

___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev

[Mesa-dev] Updating mesa3d.org docs?

2015-10-15 Thread Sarah Sharp 
Hi Brian!

I'm a new Mesa developer in Intel's OTC graphics team (although not new
to open source, I've been a Linux kernel developer for the last seven
years).

I heard that you're responsible for updating mesa3d.org documentation
against the docs in the Mesa source code repo. I noticed the docs are
out-of-date WRT the repo, and I had a couple questions:

1. What's the process for pushing updated documentation to the site?
2. How often are updated docs pushed? Once every week, month, or when
   there's a new Mesa version?
3. Any chance I could get permissions to push updated docs?  I'll be
   improving Mesa documentation as part of my new job, and I would love
   to be able to push myself once patches are accepted, rather than
   having to ping you.

Thanks,
Sarah Sharp
___
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/mesa-dev