From tony at freedomsponsors.org  Wed Aug  7 03:52:47 2013
From: tony at freedomsponsors.org (=?ISO-8859-1?Q?Tony_Fran=E7a?=)
Date: Wed, 7 Aug 2013 00:52:47 -0300
Subject: A Bugzilla plugin for FreedomSponsors. Can you help?
Message-ID: <CADeiAEcRkBo8tWKp5WhriB+c6GSnSTh_pWWPpow9cMgzVcH4HA@mail.gmail.com>

Hi everyone.

My name is Tony, I'm the founder of http://freedomsponsors.org - a
crowdfunding website for Free Software projects.

I would like FreedomSponsors to have a Bugzilla plugin that would allow
project owners to add a link on their bugzillas, so that users could
sponsor their projects.

We already have a similar plugin for JIRA.

I have no idea how to write a plugin for Bugzilla (which must be in Perl,
is that right?),
so I placed a US$ 100,00 bounty for it on FreedomSponsors
Here's the bounty link:
http://www.freedomsponsors.org/core/issue/318/a-plugin-for-bugzilla

This list was the most obvious place I could think of to tell people about
the bounty. :-)

If you would like to help out FreedomSponsors and earn 100 bucks in the
process, please go ahead.
It's also helpful if you can pass this message along to developers that
might be interested!

Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130807/2c138c23/attachment.html>

From tony at freedomsponsors.org  Fri Aug  9 04:52:38 2013
From: tony at freedomsponsors.org (=?ISO-8859-1?Q?Tony_Fran=E7a?=)
Date: Fri, 9 Aug 2013 01:52:38 -0300
Subject: A Bugzilla plugin for FreedomSponsors. Can you help?
In-Reply-To: <CADeiAEcRkBo8tWKp5WhriB+c6GSnSTh_pWWPpow9cMgzVcH4HA@mail.gmail.com>
References: <CADeiAEcRkBo8tWKp5WhriB+c6GSnSTh_pWWPpow9cMgzVcH4HA@mail.gmail.com>
Message-ID: <CADeiAEcTm1nYKY+st73CHMja64nkzTAuwAnAFTvGOKRvfM8tnA@mail.gmail.com>

Just to report the status on this :-)
The FreedomSponsors Bugzilla plugin is already available for download :-)

http://blog.freedomsponsors.org/freedomsponsors-bugzilla-plugin/


On Wed, Aug 7, 2013 at 12:52 AM, Tony Fran?a <tony at freedomsponsors.org>wrote:

> Hi everyone.
>
> My name is Tony, I'm the founder of http://freedomsponsors.org - a
> crowdfunding website for Free Software projects.
>
> I would like FreedomSponsors to have a Bugzilla plugin that would allow
> project owners to add a link on their bugzillas, so that users could
> sponsor their projects.
>
> We already have a similar plugin for JIRA.
>
> I have no idea how to write a plugin for Bugzilla (which must be in Perl,
> is that right?),
> so I placed a US$ 100,00 bounty for it on FreedomSponsors
> Here's the bounty link:
> http://www.freedomsponsors.org/core/issue/318/a-plugin-for-bugzilla
>
> This list was the most obvious place I could think of to tell people about
> the bounty. :-)
>
> If you would like to help out FreedomSponsors and earn 100 bucks in the
> process, please go ahead.
> It's also helpful if you can pass this message along to developers that
> might be interested!
>
>  Thanks!
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130809/9c937a8e/attachment.html>

From szabgab at gmail.com  Fri Aug  9 05:03:14 2013
From: szabgab at gmail.com (Gabor Szabo)
Date: Fri, 9 Aug 2013 08:03:14 +0300
Subject: Interview with Dave Miller, the leader of the Bugzilla project
Message-ID: <CABe4FJBZ83-qoJYMmAW7nw83uTjLv2t-e+njxYTVW0Y+O_pQiQ@mail.gmail.com>

hi,

about a week ago I interviewed Dave Miller for the Perl Maven show
For me as an outsider, and lurker on this list it was very interesting
to hear more about the project. I hope that this can have a little
contribution in bringing new contributors to the
project:

You can watch the interview, download the mp3 or just look at the
show-notes here:
http://perlmaven.com/dave-miller

Other episodes of the Perl Maven TV can be found here:
http://perlmaven.com/tv

regards
   Gabor


From kar at cray.com  Fri Aug  9 13:09:26 2013
From: kar at cray.com (Kent Rogers)
Date: Fri, 9 Aug 2013 08:09:26 -0500
Subject: A Bugzilla plugin for FreedomSponsors. Can you help?
In-Reply-To: <CADeiAEcTm1nYKY+st73CHMja64nkzTAuwAnAFTvGOKRvfM8tnA@mail.gmail.com>
References: <CADeiAEcRkBo8tWKp5WhriB+c6GSnSTh_pWWPpow9cMgzVcH4HA@mail.gmail.com> <CADeiAEcTm1nYKY+st73CHMja64nkzTAuwAnAFTvGOKRvfM8tnA@mail.gmail.com>
Message-ID: <20130809130926.GB15696@cray.com>

Wow, if sponsoring a fix for a bug works this well, this pluginshould be
added to Bugzilla's Bugzilla!

-Kent

On Fri, Aug 09, 2013 at 01:52:38AM -0300, Tony Fran?a wrote:
> Just to report the status on this :-)
> The FreedomSponsors Bugzilla plugin is already available for download :-)
> 
> http://blog.freedomsponsors.org/freedomsponsors-bugzilla-plugin/
> 
> 
> On Wed, Aug 7, 2013 at 12:52 AM, Tony Fran?a <tony at freedomsponsors.org>wrote:
> 
> > Hi everyone.
> >
> > My name is Tony, I'm the founder of http://freedomsponsors.org - a
> > crowdfunding website for Free Software projects.
> >
> > I would like FreedomSponsors to have a Bugzilla plugin that would allow
> > project owners to add a link on their bugzillas, so that users could
> > sponsor their projects.
> >
> > We already have a similar plugin for JIRA.
> >
> > I have no idea how to write a plugin for Bugzilla (which must be in Perl,
> > is that right?),
> > so I placed a US$ 100,00 bounty for it on FreedomSponsors
> > Here's the bounty link:
> > http://www.freedomsponsors.org/core/issue/318/a-plugin-for-bugzilla
> >
> > This list was the most obvious place I could think of to tell people about
> > the bounty. :-)
> >
> > If you would like to help out FreedomSponsors and earn 100 bucks in the
> > process, please go ahead.
> > It's also helpful if you can pass this message along to developers that
> > might be interested!
> >
> >  Thanks!
> >


From damien.nozay at gmail.com  Tue Aug 13 01:34:33 2013
From: damien.nozay at gmail.com (Damien)
Date: Mon, 12 Aug 2013 18:34:33 -0700
Subject: Self-Introduction: dnozay
Message-ID: <CAAe5jyOOYDsxv=wniNAMjwhxCL_3QnNPLPPRMSCMph2R+YCGfg@mail.gmail.com>

Damien Nozay
irc nickname: dnozay or damien (none registered)
San Francisco Bay Area, California

Working on tools in my current role, and my main objective for joining this
list is to contribute fixes upstream rather than having to customize an
instance without any support.

:)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130812/a62c7378/attachment.html>

From gerv at mozilla.org  Tue Aug 27 10:08:21 2013
From: gerv at mozilla.org (Gervase Markham)
Date: Tue, 27 Aug 2013 11:08:21 +0100
Subject: Bugzilla doesn't roll back transactions on errors when using eval
Message-ID: <X9SdnV7yJd4M54HPnZ2dnUVZ_qydnZ2d@mozilla.org>

I've just found a long-standing bug in a Bugzilla extension I maintain.

Regularly, this extension tries to create a series of bugs. Sometimes
the data for one or more of those bugs was bad (e.g. invalid version)
and this failed. This caused the entire job to die. So I wrapped the
Bugzilla::Bug->create() call in eval {} and handled the error, then
proceeded. I thought this was the right thing to do.

However, it turns out that if you are using eval(), then
Bugzilla::Bug->create() will start a transaction, but the Bugzilla error
code will not roll it back or close it:

Error.pm, lines 57-60, function _throw_error:

    # Make sure any transaction is rolled back (if supported).
    # If we are within an eval(), do not roll back transactions as we
    # are eval'uating some test on purpose.
    $dbh->bz_rollback_transaction() if ($dbh->bz_in_transaction() &&
!_in_eval());

The result was that I was still in a transaction after handling the
error. The rest of my code created more bugs, opening and closing
transactions each time, but when it all got to the end, there was still
an open transaction - and we don't call commit() until all transactions
are closed. So none of my bugs actually got created in the DB (although
the auto_increment showed that their bug numbers had been allocated)!

The fix was to manually close the transaction when I had a failure, but
the need to do this was not at all obvious.

This error behaviour seems wrong to me (in that it exposes weird
requirements on the user of an API which are not obvious and easy to
miss or get wrong), but I'm not entirely sure what the best fix is.
Comments?

Gerv
_______________________________________________
dev-apps-bugzilla mailing list
dev-apps-bugzilla at lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla


From sgreen at redhat.com  Tue Aug 27 11:31:45 2013
From: sgreen at redhat.com (Simon Green)
Date: Tue, 27 Aug 2013 21:31:45 +1000
Subject: Bugzilla doesn't roll back transactions on errors when using
 eval
In-Reply-To: <X9SdnV7yJd4M54HPnZ2dnUVZ_qydnZ2d@mozilla.org>
References: <X9SdnV7yJd4M54HPnZ2dnUVZ_qydnZ2d@mozilla.org>
Message-ID: <521C8E21.7080101@redhat.com>

On 27/08/13 20:08, Gervase Markham wrote:
> I've just found a long-standing bug in a Bugzilla extension I maintain.
> 
> The fix was to manually close the transaction when I had a failure, but
> the need to do this was not at all obvious.
> 
> This error behaviour seems wrong to me (in that it exposes weird
> requirements on the user of an API which are not obvious and easy to
> miss or get wrong), but I'm not entirely sure what the best fix is.
> Comments?

brc was also affected by a similar issue not so long ago (wrapping some
code in an eval that started a transaction, but did not finish). Took
about four hours to debug it, followed by a lot of cursing.

Since all code is run by individual *cgi or *pl scripts (and doesn't
have a global exit point), I'm not sure if there is a fix for the issue
either (other than not using eval, which is the solution I went for)

-- 
Simon Green
Software Engineer
Red Hat Asia Pacific Pty Ltd


From prakashcha44 at gmail.com  Tue Aug 27 12:44:51 2013
From: prakashcha44 at gmail.com (Prakash Chandra)
Date: Tue, 27 Aug 2013 18:14:51 +0530
Subject: Need Help for Bugzilla integration with ServiceNow-Urgent.!!
Message-ID: <CAGfT3EeRpt-6JAmqA-5e1u3wcO6RtDp3wiL9NVR-PXZ-catD8Q@mail.gmail.com>

Hi,



I have a need to integrate the Bugzilla with ServiceNow.

Kindly suggest how I should approach to achieve this integration.

 It would be really great if some documentation can be made available for
the same or some insight to the integration can be provided.

Currently I am getting clueless to where to start from.



Regards/Prakash
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130827/14f24547/attachment.html>

From sgreen at redhat.com  Tue Aug 27 13:57:11 2013
From: sgreen at redhat.com (Simon Green)
Date: Tue, 27 Aug 2013 23:57:11 +1000
Subject: Need Help for Bugzilla integration with ServiceNow
In-Reply-To: <CAGfT3EeRpt-6JAmqA-5e1u3wcO6RtDp3wiL9NVR-PXZ-catD8Q@mail.gmail.com>
References: <CAGfT3EeRpt-6JAmqA-5e1u3wcO6RtDp3wiL9NVR-PXZ-catD8Q@mail.gmail.com>
Message-ID: <521CB037.3080401@redhat.com>

On 27/08/13 22:44, Prakash Chandra wrote:
> I have a need to integrate the Bugzilla with ServiceNow.
> 
> Kindly suggest how I should approach to achieve this integration.

What level of intergration are you after? If it is simply to link SN
tickets to Bugzilla, you can use the URL field for that, and Bug.create
and Bug.update RPC calls to set the field.

>  It would be really great if some documentation can be made available
> for the same or some insight to the integration can be provided.

It really depends on what you are trying to achieve.

> Currently I am getting clueless to where to start from.

http://www.bugzilla.org/ has some excellent documentation.

-- 
Simon Green
Software Engineer
Red Hat Asia Pacific Pty Ltd


From Prakash.Chandra2 at cognizant.com  Tue Aug 27 12:41:52 2013
From: Prakash.Chandra2 at cognizant.com (Prakash.Chandra2 at cognizant.com)
Date: Tue, 27 Aug 2013 12:41:52 +0000
Subject: Need Help for integration with ServiceNow
Message-ID: <2EFF8B7D50E135448BEC927DF204780E2AE35FF9@CTSINCHNSXMBN.cts.com>

Hi,

I have a need to integrate the Bugzilla with ServiceNow.
Kindly suggest how I should approach to achieve this integration.

It would be really great if some documentation can be made available for the same.

Regards/Prakash

This e-mail and any files transmitted with it are for the sole use of the intended recipient(s) and may contain confidential and privileged information. If you are not the intended recipient(s), please reply to the sender and destroy all copies of the original message. Any unauthorized review, use, disclosure, dissemination, forwarding, printing or copying of this email, and/or any action taken in reliance on the contents of this e-mail is strictly prohibited and may be unlawful.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130827/2391b3ef/attachment.html>

From sspeiche at gmail.com  Tue Aug 27 18:35:43 2013
From: sspeiche at gmail.com (Steve Speicher)
Date: Tue, 27 Aug 2013 14:35:43 -0400
Subject: Need Help for integration with ServiceNow
In-Reply-To: <2EFF8B7D50E135448BEC927DF204780E2AE35FF9@CTSINCHNSXMBN.cts.com>
References: <2EFF8B7D50E135448BEC927DF204780E2AE35FF9@CTSINCHNSXMBN.cts.com>
Message-ID: <CAOUJ7JqO0W4OgKgSNPBGww0uu57cNQ8C=tn2w-ZPtSu+rBaZmQ@mail.gmail.com>

Hi Prakash,

I guess it all depends on the integration scenarios you are trying to
support and what the restricts are around the integration.

Take for example, you can spend a few dollars and you want a solution that
can synchronize bugs and tickets so you could use things like Tasktop Sync
http://tasktop.com or Kovair Omnibus http://kovair.com.

These also work if you have more than point-to-point tools and need fit
more into an ecosystem of tools with a consistent integration approach.

if you would like standard interfaces and just links between key resources
(ticket -> bug) then you can define some integration code leveraging things
like OSLC http://oslc.co and the Bugzilla adapter at
http://eclipse.org/lyo.  Though perhaps someone would like to do a
native extension for OSLC in
Bugzilla https://bugzilla.mozilla.org/show_bug.cgi?id=519177

Not sure if that is what you were looking for but there it is anyway.

Regards,
- Steve Speicher


On Tue, Aug 27, 2013 at 8:41 AM, <Prakash.Chandra2 at cognizant.com> wrote:

>  Hi,
>
>
>
> I have a need to integrate the Bugzilla with ServiceNow.
>
> Kindly suggest how I should approach to achieve this integration.
>
>
>
> It would be really great if some documentation can be made available for
> the same.
>
>
>
> Regards/Prakash
>
>
>  This e-mail and any files transmitted with it are for the sole use of the
> intended recipient(s) and may contain confidential and privileged
> information. If you are not the intended recipient(s), please reply to the
> sender and destroy all copies of the original message. Any unauthorized
> review, use, disclosure, dissemination, forwarding, printing or copying of
> this email, and/or any action taken in reliance on the contents of this
> e-mail is strictly prohibited and may be unlawful.
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130827/b7bb1965/attachment.html>

From prakashcha44 at gmail.com  Tue Aug 27 18:47:18 2013
From: prakashcha44 at gmail.com (Prakash Chandra)
Date: Wed, 28 Aug 2013 00:17:18 +0530
Subject: Need Help for integration with ServiceNow
In-Reply-To: <CAOUJ7JqO0W4OgKgSNPBGww0uu57cNQ8C=tn2w-ZPtSu+rBaZmQ@mail.gmail.com>
References: <2EFF8B7D50E135448BEC927DF204780E2AE35FF9@CTSINCHNSXMBN.cts.com>
	<CAOUJ7JqO0W4OgKgSNPBGww0uu57cNQ8C=tn2w-ZPtSu+rBaZmQ@mail.gmail.com>
Message-ID: <CAGfT3EchT7tba6z2EJUnxX1vuXhGjP2kJ0_MYWWxg9rST+iyaQ@mail.gmail.com>

Hi Steve,

Thanks for the info shared, really appreciated.
I completely agree with what you stated but while browsing through the
forums in Mozilla wiki, I came across certain posts which shown me some
hints that Service Now tool can be integrated with Bugzilla through some
REST WS.

My confusion is around that If someone has already explored/any extension
for this integration?

Regards/Prakash




On Wed, Aug 28, 2013 at 12:05 AM, Steve Speicher <sspeiche at gmail.com> wrote:

> Hi Prakash,
>
> I guess it all depends on the integration scenarios you are trying to
> support and what the restricts are around the integration.
>
> Take for example, you can spend a few dollars and you want a solution that
> can synchronize bugs and tickets so you could use things like Tasktop Sync
> http://tasktop.com or Kovair Omnibus http://kovair.com.
>
> These also work if you have more than point-to-point tools and need fit
> more into an ecosystem of tools with a consistent integration approach.
>
> if you would like standard interfaces and just links between key resources
> (ticket -> bug) then you can define some integration code leveraging things
> like OSLC http://oslc.co and the Bugzilla adapter at
> http://eclipse.org/lyo .  Though perhaps someone would like to do a
> native extension for OSLC in Bugzilla
> https://bugzilla.mozilla.org/show_bug.cgi?id=519177
>
> Not sure if that is what you were looking for but there it is anyway.
>
> Regards,
> - Steve Speicher
>
>
> On Tue, Aug 27, 2013 at 8:41 AM, <Prakash.Chandra2 at cognizant.com> wrote:
>
>>  Hi,
>>
>>
>>
>> I have a need to integrate the Bugzilla with ServiceNow.
>>
>> Kindly suggest how I should approach to achieve this integration.
>>
>>
>>
>> It would be really great if some documentation can be made available for
>> the same.
>>
>>
>>
>> Regards/Prakash
>>
>>
>>  This e-mail and any files transmitted with it are for the sole use of
>> the intended recipient(s) and may contain confidential and privileged
>> information. If you are not the intended recipient(s), please reply to the
>> sender and destroy all copies of the original message. Any unauthorized
>> review, use, disclosure, dissemination, forwarding, printing or copying of
>> this email, and/or any action taken in reliance on the contents of this
>> e-mail is strictly prohibited and may be unlawful.
>>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130828/fb17cbdd/attachment.html>

From gerv at mozilla.org  Wed Aug 28 12:46:00 2013
From: gerv at mozilla.org (Gervase Markham)
Date: Wed, 28 Aug 2013 13:46:00 +0100
Subject: Bugzilla doesn't roll back transactions on errors when using
 eval
In-Reply-To: <521C8E21.7080101@redhat.com>
References: <X9SdnV7yJd4M54HPnZ2dnUVZ_qydnZ2d@mozilla.org> <521C8E21.7080101@redhat.com>
Message-ID: <521DF108.7040903@mozilla.org>

On 27/08/13 12:31, Simon Green wrote:
> On 27/08/13 20:08, Gervase Markham wrote:
>> I've just found a long-standing bug in a Bugzilla extension I maintain.
>>
>> The fix was to manually close the transaction when I had a failure, but
>> the need to do this was not at all obvious.

Why do we refuse to roll back the transaction on eval? That's what I
don't get. If we don't want this transaction committed, why can't we
roll it back and then close the transaction? That keeps everything in a
consistent state.

>> This error behaviour seems wrong to me (in that it exposes weird
>> requirements on the user of an API which are not obvious and easy to
>> miss or get wrong), but I'm not entirely sure what the best fix is.
>> Comments?
> 
> brc was also affected by a similar issue not so long ago (wrapping some
> code in an eval that started a transaction, but did not finish). Took
> about four hours to debug it, followed by a lot of cursing.
> 
> Since all code is run by individual *cgi or *pl scripts (and doesn't
> have a global exit point), I'm not sure if there is a fix for the issue
> either (other than not using eval, which is the solution I went for)

Is there any way of getting some code to run always as the last thing
that happens, which can at least print "Warning: script exiting with
uncommitted and unrolled-back transactions"?



Gerv


From prakashcha44 at gmail.com  Wed Aug 28 15:19:48 2013
From: prakashcha44 at gmail.com (Prakash Chandra)
Date: Wed, 28 Aug 2013 20:49:48 +0530
Subject: Need Help for Bugzilla integration with ServiceNow
In-Reply-To: <521CB037.3080401@redhat.com>
References: <CAGfT3EeRpt-6JAmqA-5e1u3wcO6RtDp3wiL9NVR-PXZ-catD8Q@mail.gmail.com>
	<521CB037.3080401@redhat.com>
Message-ID: <CAGfT3EfJyfwnMbeokQ6WezVEds=p-wKzTY9pYP-Q0rH00CE6pA@mail.gmail.com>

Hi Simon,

Thanks for your prompt reply.
I am looking for basic integration for Bug to ticket creation/updation.

Can you please elaborate on how to use that URL field and make RPC calls?

Any help, is really appreciated.

Regards/Prakash


On Tue, Aug 27, 2013 at 7:27 PM, Simon Green <sgreen at redhat.com> wrote:

> On 27/08/13 22:44, Prakash Chandra wrote:
> > I have a need to integrate the Bugzilla with ServiceNow.
> >
> > Kindly suggest how I should approach to achieve this integration.
>
> What level of intergration are you after? If it is simply to link SN
> tickets to Bugzilla, you can use the URL field for that, and Bug.create
> and Bug.update RPC calls to set the field.
>
> >  It would be really great if some documentation can be made available
> > for the same or some insight to the integration can be provided.
>
> It really depends on what you are trying to achieve.
>
> > Currently I am getting clueless to where to start from.
>
> http://www.bugzilla.org/ has some excellent documentation.
>
> --
> Simon Green
> Software Engineer
> Red Hat Asia Pacific Pty Ltd
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130828/947054f4/attachment.html>

From gerv at mozilla.org  Sat Aug 31 13:35:00 2013
From: gerv at mozilla.org (Gervase Markham)
Date: Sat, 31 Aug 2013 14:35:00 +0100
Subject: Bugzilla docs: test conversion to RST and hosting on readthedocs.org
Message-ID: <HvSdnYqWz8KfbLzPnZ2dnUVZ_oqdnZ2d@mozilla.org>

Hi everyone,

Further to pervious emails on the subject, I've hacked up something to
convert the Bugzilla docs from Docbook to RST (ReStructured Text),
uploaded them to Github and connected the Github repo to readthedocs.org.

It's hackily done, and one thing that hasn't come across is the TOC
(which is auto-generated when using Docbook). So there isn't an index
page. But you can see the results here:

https://bugzilla.readthedocs.org/en/latest/about.html
https://bugzilla.readthedocs.org/en/latest/administration.html
https://bugzilla.readthedocs.org/en/latest/Bugzilla-Guide.html
https://bugzilla.readthedocs.org/en/latest/conventions.html
https://bugzilla.readthedocs.org/en/latest/customization.html
https://bugzilla.readthedocs.org/en/latest/gfdl.html
https://bugzilla.readthedocs.org/en/latest/glossary.html
https://bugzilla.readthedocs.org/en/latest/installation.html
https://bugzilla.readthedocs.org/en/latest/modules.html
https://bugzilla.readthedocs.org/en/latest/patches.html
https://bugzilla.readthedocs.org/en/latest/security.html
https://bugzilla.readthedocs.org/en/latest/troubleshooting.html
https://bugzilla.readthedocs.org/en/latest/using.html

I'm sure there are style and conversion nits, but I think it's good
enough to evaluate whether this is the way we want to go.

The advantages of this system is that RST is much easier to edit, Sphinx
can be installed locally (as one package) so that anyone hacking on the
docs can compile them themselves to HTML or other formats, and
readthedocs.org automatically takes care of making sure we have a lovely
web version. Because it's SCM-backed, we can have branches for each
version of Bugzilla, which was a requirement. And if and when Bugzilla
moves to Git, I'm pretty sure we can then simply keep the docs in the
same repo as the code.

Comments?

Gerv
_______________________________________________
dev-apps-bugzilla mailing list
dev-apps-bugzilla at lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla


From bugzilla at colinogilvie.co.uk  Sat Aug 31 19:51:08 2013
From: bugzilla at colinogilvie.co.uk (Colin Ogilvie)
Date: Sat, 31 Aug 2013 20:51:08 +0100
Subject: Bugzilla docs: test conversion to RST and hosting on readthedocs.org
In-Reply-To: <HvSdnYqWz8KfbLzPnZ2dnUVZ_oqdnZ2d@mozilla.org>
References: <HvSdnYqWz8KfbLzPnZ2dnUVZ_oqdnZ2d@mozilla.org>
Message-ID: <CAHdadoJfviQe1-wAQgcKMswnDOGzuq5cLLzE9HtTLernSrjFcg@mail.gmail.com>

On 31 August 2013 14:35, Gervase Markham <gerv at mozilla.org> wrote:

> Hi everyone,
>
> Further to pervious emails on the subject, I've hacked up something to
> convert the Bugzilla docs from Docbook to RST (ReStructured Text),
> uploaded them to Github and connected the Github repo to readthedocs.org.
>
> I'm sure there are style and conversion nits, but I think it's good
> enough to evaluate whether this is the way we want to go.
>
> The advantages of this system is that RST is much easier to edit, Sphinx
> can be installed locally (as one package) so that anyone hacking on the
> docs can compile them themselves to HTML or other formats, and
> readthedocs.org automatically takes care of making sure we have a lovely
> web version. Because it's SCM-backed, we can have branches for each
> version of Bugzilla, which was a requirement. And if and when Bugzilla
> moves to Git, I'm pretty sure we can then simply keep the docs in the
> same repo as the code.
>
> Comments?
>

I think this seems like quite a good idea, to be honest...

I did find a more up-to-date db2rst script at
https://github.com/kurtmckee/db2rst which might help? I've not tried it as
I'm not sure what changes you'd made in the first place.

The index issue: we could probably hard-code the generation of the list, or
at least work on a sort order... a quick 5 minute play has got me
generating an index, but it's not ideal :-)

Colin
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bugzilla.org/pipermail/developers/attachments/20130831/c026e720/attachment.html>