Re: Why do the Socorro docs have ads on them?

2019-07-05 Thread Rob Sayre via governance
On Friday, March 22, 2019 at 6:15:33 AM UTC-7, William Kahn-Greene wrote:
> 
> I don't think their advertising model goes against Mozilla's mission.
> I do think that ReadTheDocs provides a service to open source
> projects--including many of Mozilla's projects--that's invaluable and
> helps us immensely.

I don't think "readthedocs.io" provides a valuable service. It's a static 
website built from Sphinx. This would be free, without ads, on many services.

I guess the problem I have with this is that it looks a little corrupt. Like, 
why is Mozilla supplying display advertising real estate to "readthedocs.io", 
when it could easy host the pages itself, or on github, at zero cost? The worst 
interpretation would be that it pays someone's buddy.
___
governance mailing list
governance@lists.mozilla.org
https://lists.mozilla.org/listinfo/governance


Re: Why do the Socorro docs have ads on them?

2019-03-22 Thread Rob Sayre via governance
On Friday, March 22, 2019 at 1:01:15 PM UTC-7, Andrew Halberstadt wrote:
> 
> Maybe if Mozilla wants to continue supporting them while simultaneously
> getting rid of ads and using our own domains/branding, we could sign up
> for a corporate account:
> https://readthedocs.com/pricing/

That seems totally reasonable. That way, the price would be up front and 
documented.

thanks,
Rob
___
governance mailing list
governance@lists.mozilla.org
https://lists.mozilla.org/listinfo/governance


Re: Why do the Socorro docs have ads on them?

2019-03-22 Thread Andrew Halberstadt via governance
It is possible to build documentation with Travis and host it with pages,
e.g:
https://gist.github.com/brenns10/f48e1021e8befd2221a2

But it still requires more effort than the single button click that
readthedocs
provides. I personally don't think there's anything wrong with hosting docs
there, and it's worth mentioning that readthedocs was a MOSS recipient.

Maybe if Mozilla wants to continue supporting them while simultaneously
getting rid of ads and using our own domains/branding, we could sign up
for a corporate account:
https://readthedocs.com/pricing/

I imagine it would be a lot cheaper than asking employees to spend time
figuring out how to host their docs with Github Pages (which is also a for-
profit company btw).

- Andrew



On Fri, Mar 22, 2019 at 12:34 PM Rob Sayre via governance <
governance@lists.mozilla.org> wrote:

> On Friday, March 22, 2019 at 6:15:33 AM UTC-7, William Kahn-Greene wrote:
> >
> > I don't think their advertising model goes against Mozilla's mission.
> > I do think that ReadTheDocs provides a service to open source
> > projects--including many of Mozilla's projects--that's invaluable and
> > helps us immensely. I don't know offhand if we currently support them
> > or not. If we don't, we really should. I'm pretty sure we have in the
> > past.
>
> It's not the ads themselves that bother me, but rather that Mozilla's
> documentation is being served by a for-profit company. Firefox hosts their
> own:
>
> http://firefox-source-docs.mozilla.org/
>
> It seems like the output of Sphinx could be hosted on Github Pages for
> free...
>
> thanks,
> Rob
> ___
> governance mailing list
> governance@lists.mozilla.org
> https://lists.mozilla.org/listinfo/governance
>
___
governance mailing list
governance@lists.mozilla.org
https://lists.mozilla.org/listinfo/governance


Re: Why do the Socorro docs have ads on them?

2019-03-22 Thread Rob Sayre via governance
On Friday, March 22, 2019 at 6:15:33 AM UTC-7, William Kahn-Greene wrote:
> 
> I don't think their advertising model goes against Mozilla's mission.
> I do think that ReadTheDocs provides a service to open source
> projects--including many of Mozilla's projects--that's invaluable and
> helps us immensely. I don't know offhand if we currently support them
> or not. If we don't, we really should. I'm pretty sure we have in the
> past.

It's not the ads themselves that bother me, but rather that Mozilla's 
documentation is being served by a for-profit company. Firefox hosts their own: 

http://firefox-source-docs.mozilla.org/

It seems like the output of Sphinx could be hosted on Github Pages for free...

thanks,
Rob
___
governance mailing list
governance@lists.mozilla.org
https://lists.mozilla.org/listinfo/governance


Re: Why do the Socorro docs have ads on them?

2019-03-22 Thread William Kahn-Greene via governance
Socorro's documentation is built by and hosted on ReadTheDocs as is
documentation for many Mozilla projects. ReadTheDocs uses "ethical
advertising" to fund the infrastructure. They talk more about that
here:

https://docs.readthedocs.io/en/latest/advertising/ethical-advertising.html

I don't think their advertising model goes against Mozilla's mission.
I do think that ReadTheDocs provides a service to open source
projects--including many of Mozilla's projects--that's invaluable and
helps us immensely. I don't know offhand if we currently support them
or not. If we don't, we really should. I'm pretty sure we have in the
past.

/will

On Fri, Mar 22, 2019 at 3:54 AM Rob Sayre via governance
 wrote:
>
> Hi!
>
> I had occasion to look around Socorro, and I noticed the documentation has 
> ads. Why is this? At first, I thought I might have happened on random 
> shovelware, but it seems that
>
> https://github.com/mozilla-services/socorro
>
> links to
>
> https://socorro.readthedocs.io/en/latest/
>
> I named Socorro and the "collector", which is what I was looking at. I was 
> surprised to see a banner ad on the docs for this software. There are 
> probably no lines of code written by me left, but it is nevertheless 
> troubling.
>
> It doesn't seem consistent with Mozilla's mission to serve static 
> documentation with ads. For example, MDN doesn't work this way.
>
> thanks,
> Rob
> ___
> governance mailing list
> governance@lists.mozilla.org
> https://lists.mozilla.org/listinfo/governance
___
governance mailing list
governance@lists.mozilla.org
https://lists.mozilla.org/listinfo/governance