How do you keep documentation so nice?

Thomas Caswell tcaswell at gmail.com
Thu Dec 11 12:57:58 EST 2014


matplotlib uses the organization-level gh-pages to host the documentation
which seems to work pretty well.

On Thu Dec 11 2014 at 12:45:30 PM Adam Hughes <hughesadam87 at gmail.com>
wrote:

> Thanks, that's great advice.  Also, do you guys pay to host your site?
> Can you recommend a low-cost, or free, static-website hosting vendor?  We
> are currently using gh-pages branch on github to host our site, and I
> really hate having this secondary branch.  Especially when I need the
> documentation to have access to the source code modules or setup.py file
> (as it's on a second branch).
>
> On Thu, Dec 11, 2014 at 6:56 AM, Juan Nunez-Iglesias <jni.soma at gmail.com>
> wrote:
>>
>> Adam, just fyi, we are considering moving away from GoogleGroups... (See
>> a separate discussion on this list). Since you are on the ground floor, you
>> might want to reconsider your choice. I've been using Nabble for my (very
>> low volume!) gala list and it's been really good.
>>
>>
>>
>>
>> On Thu, Dec 11, 2014 at 12:01 PM, Adam Hughes <hughesadam87 at gmail.com>
>> wrote:
>>
>>> Thanks Michael.
>>>
>>> Be warned, only about 3 people are using the library at the moment, so
>>> it's quite likely that you'll encounter some bugs just by virtue of using a
>>> new dataset that probably will bring to light some considerations that we
>>> overlooked.  In addition, I only support pandas 0.14 right now (0.15 has a
>>> lot of private API changes that directly affect us).  But we did feel like
>>> the library was close enough to ready to share it, and I hope you can try
>>> it out.  If you do want to give it a whirl sometime soon, please feel free
>>> to contact us at skspec at googlegroups.com (or me personally) and we will
>>> at least make sure to help get you up and running.  Let us know what kind
>>> of data you're working on and what type of analysis you're doing.  We've
>>> spend a lot of time putting out datastructures together, but we haven't put
>>> a great deal of thought into the actual spectral utilitiles, workflows and
>>> analysis that we should host, other than correlation spectroscopy and base
>>> things like dynamic baseline fitting.
>>>
>>>
>>>
>>> On Wed, Dec 10, 2014 at 6:14 PM, Michael Aye <kmichael.aye at gmail.com>
>>> wrote:
>>>
>>>>  On 2014-12-10 02:43:46, Adam Hughes <hughes... at gmail.com> wrote:
>>>>
>>>>> > http://hugadams.github.io/scikit-spectra/
>>>>>>>
>>>>>>> That is a very impressive notebook widget shown in the video!  I love
>>>>>>> how it interacts with mpl3d.
>>>>>>>
>>>>>>>
>>>>>>> Ditto! Man, can't wait to play with this! Very happy that there's
>>>> finally a package focusing on spectral analysis! It also just comes at the
>>>> right time, just started in my new job working on data from an imaging
>>>> spectrometer for the first time. ;)
>>>>
>>>> Michael
>>>>
>>>>
>>>> --
>>>> You received this message because you are subscribed to a topic in the
>>>> Google Groups "scikit-image" group.
>>>> To unsubscribe from this topic, visit
>>>> https://groups.google.com/d/topic/scikit-image/k5K6_vanZVI/unsubscribe.
>>>> To unsubscribe from this group and all its topics, send an email to
>>>> scikit-image+unsubscribe at googlegroups.com.
>>>> For more options, visit https://groups.google.com/d/optout.
>>>>
>>>
>>>  --
>>> You received this message because you are subscribed to the Google
>>> Groups "scikit-image" group.
>>> To unsubscribe from this group and stop receiving emails from it, send
>>> an email to scikit-image+unsubscribe at googlegroups.com.
>>> For more options, visit https://groups.google.com/d/optout.
>>>
>>
>>  --
>> You received this message because you are subscribed to a topic in the
>> Google Groups "scikit-image" group.
>> To unsubscribe from this topic, visit
>> https://groups.google.com/d/topic/scikit-image/k5K6_vanZVI/unsubscribe.
>> To unsubscribe from this group and all its topics, send an email to
>> scikit-image+unsubscribe at googlegroups.com.
>> For more options, visit https://groups.google.com/d/optout.
>>
>  --
> You received this message because you are subscribed to the Google Groups
> "scikit-image" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to scikit-image+unsubscribe at googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scikit-image/attachments/20141211/34c72398/attachment.html>


More information about the scikit-image mailing list