Return-Path: X-Original-To: apmail-lucene-commits-archive@www.apache.org Delivered-To: apmail-lucene-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 52075100B6 for ; Mon, 18 Nov 2013 21:35:00 +0000 (UTC) Received: (qmail 85369 invoked by uid 500); 18 Nov 2013 21:35:00 -0000 Mailing-List: contact commits-help@lucene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@lucene.apache.org Delivered-To: mailing list commits@lucene.apache.org Received: (qmail 85356 invoked by uid 99); 18 Nov 2013 21:35:00 -0000 Received: from cwiki-vm.apache.org (HELO cwiki-vm) (140.211.11.69) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 18 Nov 2013 21:35:00 +0000 Received: from cwiki-vm (localhost [127.0.0.1]) by cwiki-vm (Postfix) with ESMTP id 08201A2650 for ; Mon, 18 Nov 2013 21:35:00 +0000 (UTC) Date: Mon, 18 Nov 2013 21:35:00 +0000 (UTC) From: "Cassandra Targett (Confluence)" To: commits@lucene.apache.org Message-ID: <187768421.27518.1384810500032.JavaMail.confluence@cwiki-vm> Subject: [CONF] Apache Solr Reference Guide > Internal - TODO List MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Auto-Submitted: auto-generated Space: Apache Solr Reference Guide (https://cwiki.apache.org/confluence/display/solr) Page: Internal - TODO List (https://cwiki.apache.org/confluence/display/solr/Internal+-+TODO+List) Edited by Cassandra Targett: --------------------------------------------------------------------- This page serves as a place to organize thoughts and collect lists of things to try and fix / clean up. If you are in the process of looking into something, or imminently plan to start looking into something -- please put your name under it. If you complete something on this list, please delete it. {note}a lot of these are from an email sarowe sent in response to the "VOTE RC0 Release apache-solr-ref-guide-4.5.pdf" thread, so any page numbers mentioned are likely related to that PDF{note} * 1. Pg 2: The section links from the TOC all take you to the previous page, rather than to the top of the page where the section starts. (Same behavior on OS X Preview, and under Windows, on Firefox's built-in PDF viewer and on Adobe Reader.) This looks like a general problem - see e.g. Pg 99&100: Under solr.HTMLStripCharFilterFactory, the links labeled "Major Changes from Solr 3 to Solr 4." go one page previous to the start of this section in the guide. ** sarowe, ctargett, hoss, steffkes looked into it but couldn't figure out a good fix (shelved) h2. TODO for 4.6 # Possible future PDF format fixes: ## Add some hspace in the PDF around images - in many cases the text is bumping up against the borders (see p. 15, 19, 21 specifically). ## Widow control for tables? See p. 47-48, where the table header is on one page and the content on the other. Not sure if it's possible, though. ## Some code blocks are stretched across more pages than necessary, with lots of vertical blank space, e.g. pp 137-9, 156-8, 298-300 ## table on p 261 has extra columns in one row ## zookeeper ensemble code block on 292 is missing leading whitespace ## URLs in the ReplicationHandler table have underscores, probably intended to cause underlined styling, but this doesn't work - either figure out how to underline those parts, or remove the surrounding underlines. A few comments from Robert (from [this email|http://mail-archives.apache.org/mod_mbox/lucene-dev/201310.mbox/%3CCAOdYfZWV-dGV1OfQ0rAAhDD7hv5wwV3cOmkiGiq%2B7Dj%2B7BA23g%40mail.gmail.com%3E]): * page 5: "To confirm your installation, go to the Solr Admin pageat" <-\- it reads with no space to my viewer. Maybe there is not a missing space and its just a PDF rendering/font issue or something like that. ** CT: it wasn't obvious from the online page, but the PDF doesn't deal well with non-breaking space markers instead of spaces and there was one on either side of the 'at' in that sentence. I removed those, so this should be fixed. * page 12: "Begining with 4.4..." <-\- spelling. Also, in the same paragraph, "you should changed this to use useCompoundFile": should be "change". I also wonder if its possible to prevent "useCompoundFile" from wrapping in the strange way it does? I think when e.g. quoting literal configuration strings like this it would be ideal if it didnt line break in the middle... I don't know if thats possible though. ** CT: Fixed the spelling errors. I also moved the hyperlink to later in the sentence, so hopefully that will help this issue. Issues from CHANGES.txt to be done: * [SOLR-5167|https://issues.apache.org/jira/browse/SOLR-5167]: AnalyzingInfixSuggester ** CT: added simple information about this; probably needs a bit more verbiage * [SOLR-5338|https://issues.apache.org/jira/browse/SOLR-5338]: Using split.key param to split shards * [SOLR-5353|https://issues.apache.org/jira/browse/SOLR-5353]: Using split.key param to split documents in cores * [SOLR-5027|https://issues.apache.org/jira/browse/SOLR-5027]: CollapsingQParser - already has a page in the Solr wiki: [https://wiki.apache.org/solr/CollapsingQParserPlugin] ** CT: added initial page, which is basically a copy of the wiki page. I'd like to see better examples using real-ish field names. * [SOLR-5310|https://issues.apache.org/jira/browse/SOLR-5310]: Delete replica; description is there, only needs an example API call * [SOLR-5374|https://issues.apache.org/jira/browse/SOLR-5374]: User-configured doc-centric versioning rules * [SOLR-5084|https://issues.apache.org/jira/browse/SOLR-5084]: Enum field type h1. TODO for Solr 4.7 * [http://wiki.apache.org/solr/Editing%20configuration%20files%20in%20the%20admin%20UI]. Stop watching space: https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=solr Change email notification preferences: https://cwiki.apache.org/confluence/users/editmyemailsettings.action