[
https://issues.apache.org/jira/browse/LUCENE-3750?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13204827#comment-13204827
]
Hoss Man commented on LUCENE-3750:
----------------------------------
FWIW: while i love the ability to do quick edits using the CMS bookmarklet, i
have had absolutely zero success doing a full site build on my local machine --
i'm not even getting errors, i'm just getting no output.
this may just be something really flakey about my machine, but it begs the
question: for our _versioned_ per release documentation, is there really any
advantage to using markdown over simply editing HTML directly?
we used forrest for the versioned docs solely because once upon a time the
entire site use to be versioned, and it was easy to just extract the versioned
docs from the non-versioned docs and keep using forrest for both and have a
similar look/feel, but is there really any reason why the versioned docs we
ship in the release need to be in markdown and/or have the same look/feel as
the website? yes, we'll archive them on the website for refrence, but we also
archive the javadocs and we've never tried to make them look like the forrest
docs (or the new site style)
why not just leave the versioned docs looking very simple, and very distinctive
from the website, so when people browsing them online see them it's very
obvious that they are *not* just part of the website, they are a snapshot of
per version documentation?
> Convert Versioned docs to Markdown/New CMS
> ------------------------------------------
>
> Key: LUCENE-3750
> URL: https://issues.apache.org/jira/browse/LUCENE-3750
> Project: Lucene - Java
> Issue Type: Improvement
> Reporter: Grant Ingersoll
> Priority: Minor
>
> Since we are moving our main site to the ASF CMS (LUCENE-2748), we should
> bring in any new versioned Lucene docs into the same format so that we don't
> have to deal w/ Forrest anymore.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
