lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Yonik Seeley <yo...@lucidimagination.com>
Subject Re: [DISCUSS] New Website
Date Wed, 01 Feb 2012 14:56:56 GMT
On Tue, Jan 31, 2012 at 7:21 PM, Chris Hostetter
<hossman_lucene@fucit.org> wrote:
>
> : So, I'd suggest everyone give it a pass through, fix items as they see
> : them and/or otherwise pitch in and help, because I'm tired of our
> : current site and how poor it makes us look.
>
> Grant: my one concern is how the Solr tutorial currently looks,
> particularly related to inline code and bulk code blocks...
>
> http://lucene.staging.apache.org/solr/tutorial.html

The solr tutorial represents 20% of page hits across the entire
lucene.apache.org domain.... more than 2000 views per day.
However it should be fixed, lets fix it!

-Yonik
lucidimagination.com


> to clarify: i think ultimatley the tutorial shouldn't be part of the site
> itself, because i think that should remain "unversioned" and the tutorial
> should move into "version specific" documentation of some kind (ie: maybe
> just a javadoc doc-files or some other file under the solr dev tree). ...
> but we can worry about that seperately.
>
> my real concern is that the tutorial serves as a good indicator of how
> inline and block code elements seem to be handled by the new CMS markup
> and our templates -- and that worries me for our ability to move
> forward writing docs/news/examples in the CMS given how poorly it seems to
> be handled in the tutorial right now.
>
> places where there should be inlined 'code' in a fixed width
> font, ie...
>
>> Begin by unziping the Solr release and changing your working directory
>> to be the "<code>example</code>" directory.  (Note that the base
>> directory name may vary with the version of Solr downloaded.)  For
>> example, with a shell in UNIX, Cygwin, or MacOS:
>
> ...is instead showing up as indented code blocks with a colored
> background.
>
> Meanwhile, places where there should be indented code blocks with a
> colored background...
>
> <source>
> user:~solr$ *ls*
> solr-nightly.zip
> user:~solr$ *unzip -q solr-nightly.zip*
> user:~solr$ *cd solr-nightly/example/*
> </source>
>
> ...is showing up as a single line of text in a regular variable width
> font.
>
> I don't know if the problem is:
>  * the markup processing engine
>  * our use of the markup
>  * our templates
>  * our css
>
> ...but it seems like we should figure that out.
>
>
>
> -Hoss
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message