[SeasonOfDocs] Website for TheGoodDocsProject

[Jennifer Rondeau]

I'm strongly in favor of keeping it simple until we know definitively that
we need greater complexity. Netlify is beautifully simple, yes, but the
more we establish our own publishing flow right off, the less flexibility
we have as we work out whatever relationship we want to have with Write the
Docs. (That said, moving off Netlify wouldn't be a big deal -- but if you
want publishing/hosting, why don't we ask Eric about Read the Docs? I still
think it's too early to decide on anything beyond GH pages, but if we want
to consider options now, RTD should be the mix.)

On Sun, Jul 21, 2019 at 5:19 PM Jo Cook <jo.k.cook at gmail.com> wrote:

> OK cool, but I've never had a problem setting up a custom domain on
> GitHub, personally?
>
> Jo
>
> On Sun, 21 Jul 2019, 22:05 Kyle Lobo, <kylelobo11898 at gmail.com> wrote:
>
>> To deploy a website on Netlify, all we need is a GitHub repo (which is
>> also the case with GitHub pages). Changes made on the GitHub repo are
>> automatically deployed to the Netlify website. Also, setting up custom
>> domains is really easy in Netlify.
>>
>> On Mon, Jul 22, 2019 at 2:02 AM Jo Cook <jo.k.cook at gmail.com> wrote:
>>
>>> I agree up to a point but with GitHub, all we require for people to be
>>> involved either contributing to the website or the templates is one GitHub
>>> account, whereas if we go with a different service we're increasing the
>>> barriers to participation.
>>>
>>> Jo
>>>
>>> On Sun, 21 Jul 2019, 21:27 Kyle Lobo, <kylelobo11898 at gmail.com> wrote:
>>>
>>>> I personally feel like we won't be needing comments, forms (Google
>>>> forms ftw), chatbots, survey results or video streaming. Also,
>>>> if we are planning to use a static hosting service such as GitHub
>>>> pages, I'd recommend we use something like Netlify instead of GitHub pages.
>>>>
>>>> Regards,
>>>> Kyle
>>>>
>>>> On Mon, Jul 22, 2019 at 1:08 AM Sanket Totewar <sanket at totewar.com>
>>>> wrote:
>>>>
>>>>> Quick question guys. Have we finalized on GitHib pages or open to
>>>>> using a content management system (CMS) such as Wordpress or Drupal?
>>>>>
>>>>> I reckon in the near future, we may want to allow SSL, subdomains,
>>>>> comments, forms, chatbots, survey results, video streaming, and
>>>>> downloadables, etc. on the project website. So while it's great to add a
>>>>> readme.md on the code that we host on GitHub, I personally believe we
>>>>> should move to a CMS. Here's a website I put together last year in less
>>>>> than two hours using Wordpress: https://www.totewar.com/
>>>>>
>>>>> If we ever create an API, it would make it easier for us to host
>>>>> swagger documentation using a front end such as slate on an endpoint of our
>>>>> choice. Here's something I put up 5 years ago:
>>>>> https://www.contentstack.com/docs/apis/content-management-api/
>>>>>
>>>>> I'm happy to pay for the costs. Would recommend purchasing from Google
>>>>> Domains as they're far better than GoDaddy and others. We could use the AWS
>>>>> free tier to host for free for up to a year and get free SSL and content
>>>>> delivery using Cloudflare. Do we have a budget committee or a nominated
>>>>> treasurer?
>>>>>
>>>>> I'd love to be more involved in this part of the project but I want to
>>>>> hear your thoughts first. :)
>>>>>
>>>>> Regards,
>>>>> Sanket
>>>>>
>>>>> On Mon, Jul 22, 2019 at 3:48 AM Jo Cook <jo.k.cook at gmail.com> wrote:
>>>>>
>>>>>> Hi Felicity,
>>>>>>
>>>>>> There's a list of supported themes here:
>>>>>> https://pages.github.com/themes/. Some are better than others!
>>>>>>
>>>>>> For uk.osgeo.org we use https://github.com/orderedlist/minimal which
>>>>>> is, as it says, extremely minimal but it holds up well. We use an
>>>>>> additional element to automatically render csv files as tables, but that
>>>>>> has slipped my mind for the moment.
>>>>>>
>>>>>> URLs- thegooddocsproject.org does seem to be available. I would be
>>>>>> happy to pay the cost of that domain if we want to go for it (the first
>>>>>> place I saw has it at £15.99 which is not a massive outlay).
>>>>>>
>>>>>> Regards
>>>>>>
>>>>>> Jo
>>>>>>
>>>>>> On Sun, Jul 21, 2019 at 1:14 AM Felicity Brand <
>>>>>> felicitybrand at gmail.com> wrote:
>>>>>>
>>>>>>> Hi gang,
>>>>>>>
>>>>>>> I've been experimenting with github pages to make a website.
>>>>>>>
>>>>>>> Here is the repo:
>>>>>>> https://github.com/thegooddocs/thegooddocs.github.io
>>>>>>>
>>>>>>> This is the URL: https://thegooddocs.github.io/
>>>>>>>
>>>>>>> If anyone feels like hooking it up to Jekyll/Markdown whatever to
>>>>>>> make it beautiful please jump in. Let me know if you have any access
>>>>>>> issues. Also, it's just placeholder text I put on that page. Go ahead and
>>>>>>> change it.
>>>>>>>
>>>>>>> Are we going to pay for a custom domain to get a nicer URL?
>>>>>>>
>>>>>>> Cheers
>>>>>>> Felicity
>>>>>>>
>>>>>>>
>>>>>>> _______________________________________________
>>>>>>> SeasonOfDocs mailing list
>>>>>>> SeasonOfDocs at lists.osgeo.org
>>>>>>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>>>>>>
>>>>>>
>>>>>>
>>>>>> --
>>>>>> ------------------------
>>>>>> http://about.me/jocook
>>>>>> _______________________________________________
>>>>>> SeasonOfDocs mailing list
>>>>>> SeasonOfDocs at lists.osgeo.org
>>>>>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>>>>>
>>>>> _______________________________________________
>>>>> SeasonOfDocs mailing list
>>>>> SeasonOfDocs at lists.osgeo.org
>>>>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>>>>
>>>> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190721/5dc02be1/attachment.html>