You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Steve Rowe (JIRA)" <ji...@apache.org> on 2017/05/25 22:13:04 UTC

[jira] [Commented] (SOLR-10749) Should ref guide asciidoc files' line length be limited?

    [ https://issues.apache.org/jira/browse/SOLR-10749?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16025470#comment-16025470 ] 

Steve Rowe commented on SOLR-10749:
-----------------------------------

The most recent discussions about code line length:

"Line length in Lucene/Solr code", February 2013: [https://lists.apache.org/thread.html/32a568c5772f3d23224b92b8350298062ffb13cc5227f27b94aabbef@1361788759@%3Cdev.lucene.apache.org%3E]

"Change line length setting in eclipse to 120 chars", April 2015: [https://lists.apache.org/thread.html/8fea0227dccd362f5457d0b608a8afe31f7aad448a54a8c29d16d057@1429340836@%3Cdev.lucene.apache.org%3E]



> Should ref guide asciidoc files' line length be limited?
> --------------------------------------------------------
>
>                 Key: SOLR-10749
>                 URL: https://issues.apache.org/jira/browse/SOLR-10749
>             Project: Solr
>          Issue Type: Sub-task
>      Security Level: Public(Default Security Level. Issues are Public) 
>            Reporter: Steve Rowe
>            Priority: Minor
>
> From [~dsmiley] and [~janhoy] on SOLR-10290:
> {quote}
> David: Can we auto-linewrap the asciidoc content we've imported somehow? The lines are super-long in my IDE (IntelliJ). I can toggle the active editor's "soft wrap" at least (View menu, then Active Editor menu).
> Jan: Yea, those lines are long
> {quote}
> From a conversation [~ctargett] and I had on SOLR-10379:
> {quote}
> Steve: I updated the ref guide docs. While I was at it, I installed and used the IntelliJ plugin named "Wrap To Column" to wrap at 120 chars (a.k.a. "fill paragraph") in the two .adoc files I edited.
> Cassandra: What is the point of this, or even, the big deal about asking your IDE to do soft wraps instead?
> Steve: Not all editors support soft-wrapping. There is project consensus to wrap code at 120-chars; why make an exception for these doc files?
> {quote}



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

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