So, from what I'm told by the site-dev guys, the first commit of docs would be
a pain in the ass - becuase there are so many files. But as long as you are
rarely updating docs, making other changes to your site should be quick. That
has not been my experience in the past - but this time if it doesn't work as
they say, I've got them on the line to help me figure out why it's not working
that way. I think that we won't be publishing docs that often, so every blue
moon, docs will be a painful process, but otherwise we should be alright. Does
that work?
> Date: Wed, 15 Feb 2012 11:18:40 -0800
> From: currens.ch...@gmail.com
> To: lucene-net-dev@lucene.apache.org
> Subject: Re: [Lucene.Net] Blog Setup
>
> That's similar to a suggestion Stefan made in another email:
>
> > The only alternative would be [...] running a
> > dynamic server on a dedicated VM. The later would
> > be easier to negotiate for a top level project.
>
> Though, his response seems to imply that it would need to stay hosted on
> Apache servers? I'm really only saying that because it was suggested to
> negotiate it for a top level project, and the use of an outside server
> wasn't actually suggested by him. If we can host outside of Apache
> servers, that does seems like the most straightforward answer to our
> problem, that would require the least amount of changes to our build
> process (probably).
>
> In regards to readthedocs.org, I think it only supports restructured text?
> You have to use Sphinx (python) to output your documentation which uses
> restructured text. I don't know if we can output that from sandcastle.
> Maybe there would be another way to export the xmldoc to that format, but
> idk, probably not worth the amount of effort it would take to put that in
> our build steps.
>
>
> Thanks,
> Christopher
>
> On Wed, Feb 15, 2012 at 10:59 AM, Troy Howard <thowar...@gmail.com> wrote:
>
> > Why not move docs to http://readthedocs.org/
> >
> > On Wed, Feb 15, 2012 at 10:45 AM, Christopher Currens
> > <currens.ch...@gmail.com> wrote:
> > > Erg. Was it related to the whole documentation thing? I'm pretty sure
> > > it's "frowned upon" for our documentation to break SVN every time we do a
> > > release, so we should probably figure out a solution for that. :P
> > >
> > >
> > > Thanks,
> > > Christopher
> > >
> > > On Wed, Feb 15, 2012 at 10:28 AM, Prescott Nasser <geobmx...@hotmail.com
> > >wrote:
> > >
> > >>
> > >> Ick, I'm in the middle of publishing and working with Joe @ site-dev.
> > >> We've totally f'd up svn. He's asked we stop doing things and he's
> > going to
> > >> fix it and get back to us... At least we're active.. ;) ~P
> > >> > Date: Wed, 15 Feb 2012 10:20:29 -0800
> > >> > From: currens.ch...@gmail.com
> > >> > To: lucene-net-dev@lucene.apache.org
> > >> > Subject: Re: [Lucene.Net] Blog Setup
> > >> >
> > >> > I made some changes to the website in staging. Just a few things
> > >> regarding
> > >> > the blog list, a little bit of left padding and adding a recent news
> > >> header
> > >> > above it. I also changed the link style a little bit. Feel free to
> > >> revert
> > >> > any/all changes I've made. :)
> > >> >
> > >> >
> > >> > Thanks,
> > >> > Christopher
> > >> >
> > >> > On Tue, Feb 14, 2012 at 9:05 PM, Prescott Nasser <
> > geobmx...@hotmail.com
> > >> >wrote:
> > >> >
> > >> > >
> > >> > > Editing the site: http://www.apache.org/dev/cms#usage Staging:
> > >> > > http://lucene.net.staging.apache.org/lucene.net/
> > >> > > > Date: Tue, 14 Feb 2012 11:03:58 -0800
> > >> > > > From: currens.ch...@gmail.com
> > >> > > > To: lucene-net-dev@lucene.apache.org
> > >> > > > Subject: Re: [Lucene.Net] Blog Setup
> > >> > > >
> > >> > > > Looks like the blog was successfully setup (that was quick!). You
> > >> can
> > >> > > > access it here: https://blogs.apache.org/lucenenet/
> > >> > > >
> > >> > > > I've migrated the whopping 3 new entries we already have on our
> > >> > > > index/front-page in the news section over to the blog. I would
> > give
> > >> a
> > >> > > shot
> > >> > > > at integrating it into the website, but I actually have no idea
> > how
> > >> to
> > >> > > edit
> > >> > > > the website. :)
> > >> > > >
> > >> > > >
> > >> > > > Thanks,
> > >> > > > Christopher
> > >> > > >
> > >> > > > On Mon, Feb 13, 2012 at 6:17 PM, Prescott Nasser <
> > >> geobmx...@hotmail.com
> > >> > > >wrote:
> > >> > > >
> > >> > > > >
> > >> > > > > I've submitted a ticket here:
> > >> > > > > https://issues.apache.org/jira/browse/INFRA-4433 I only added
> > my
> > >> > > name, I
> > >> > > > > wasn't sure who else would want access - if you do want it,
> > submit
> > >> a
> > >> > > > > comment to that ticket with your apache username and full name.
> > >> I'm
> > >> > > going
> > >> > > > > to try and integrate this into the site soon. I also have some
> > >> ideas
> > >> > > about
> > >> > > > > how to utilize the blog that I'll outline after I get it up and
> > >> > > running ~P
> > >> > > > > > From: bode...@apache.org
> > >> > > > > > To: lucene-net-...@incubator.apache.org
> > >> > > > > > Date: Mon, 13 Feb 2012 13:39:11 +0100
> > >> > > > > > Subject: [Lucene.Net] Blog Setup
> > >> > > > > >
> > >> > > > > > Hi all,
> > >> > > > > >
> > >> > > > > > If we want a blog for Lucene.Net on blogs.apache.org, the
> > >> > > instructions
> > >> > > > > > to request one are at
> > >> > > > > > <
> > >> > >
> > >> https://cwiki.apache.org/confluence/display/INFRA/Resource+request+FAQs
> > >> > > > > >
> > >> > > > > > Mainly we should have a list of ASF ids of the initial set of
> > >> admins
> > >> > > and
> > >> > > > > > authors.
> > >> > > > > >
> > >> > > > > > I had a look at how the RSS snippets are added to
> > www.apache.org
> > >> 's
> > >> > > index
> > >> > > > > > page and it doesn't look to difficult to adapt.
> > >> > > > > >
> > >> > > > > > In
> > >> > > > > > <
> > >> > > > >
> > >> > >
> > >>
> > https://svn.apache.org/repos/asf/infrastructure/site/trunk/content/index.html
> > >> > > > > >
> > >> > > > > > there is
> > >> > > > > >
> > >> > > > > > {% for e in blog.list %}
> > >> > > > > > <h4><a href="{{ e.url }}">{{ e.title }}</a></h4>
> > >> > > > > > <div class="section-content">{{
> > >> e.content|safe|truncatewords_html:50
> > >> > > > > }}</div>
> > >> > > > > > <hr>
> > >> > > > > > {% endfor %}
> > >> > > > > >
> > >> > > > > > which iterates over a blogs collection created in path.pm via
> > >> > > > > >
> > >> > > > > > [qr!^/index\.html$!, news_page =>
> > >> > > > > > {
> > >> > > > > > blog => ASF::Value::Blogs->new(blog =>
> > "foundation",
> > >> > > limit=>
> > >> > > > > 3),
> > >> > > > > > },
> > >> > > > > > ],
> > >> > > > > >
> > >> > > > > > and uses the ASF::Value::Blog package that is part of the CMS.
> > >> > > > > > <
> > >> > > > >
> > >> > >
> > >>
> > https://svn.apache.org/repos/infra/websites/cms/build/lib/ASF/Value/Blogs.pm
> > >> > > > > >
> > >> > > > > >
> > >> > > > > > So getting content from the blog to the main page is pretty
> > >> easy. I
> > >> > > > > > think the main site is re-created every fifteen minutes to
> > ensure
> > >> > > things
> > >> > > > > > are fresh, not sure how one would go about this for a page
> > that
> > >> > > doesn't
> > >> > > > > > change that often (manually triggering buildbot might be an
> > >> option).
> > >> > > > > > We'd need to ask this on the site-dev mailing list which is
> > >> > > dedicated to
> > >> > > > > > the CMS.
> > >> > > > > >
> > >> > > > > > Stefan
> > >> > > > >
> > >> > > > >
> > >> > >
> > >> > >
> > >>
> > >>
> >
