[Hackage] #346: Add a warning for synopsis being a prefix of the description

[Hackage]

#346: Add a warning for synopsis being a prefix of the description
----------------------------+-----------------------------------------------
  Reporter:  guest          |        Owner:        
      Type:  defect         |       Status:  new   
  Priority:  normal         |    Milestone:        
 Component:  Cabal library  |      Version:  HEAD  
  Severity:  normal         |   Resolution:        
  Keywords:                 |   Difficulty:  normal
Ghcversion:  6.8.2          |     Platform:        
----------------------------+-----------------------------------------------
Comment (by guest):

 I thought the description wasn't meant to replicate the summary, but
 checking the Cabal manual I can't actually see that guideline. So what is
 the recommended ruling? Should the description stand alone without the
 summary? Should they be both shown if you want to display more? Could the
 Cabal manual make a ruling on this, so at least I can follow whatever
 guidelines are proposed.

 My personal view is that the Description should not restate the summary,
 but be a fresh description of the package, which makes sense without the
 summary. However, when displaying the description the summary should
 always be displayed as well. This is pretty much the same idea as
 Abstract(Summary) and Introduction(Description) in a paper.

 -- Neil (who wonders how to get a hackage trac account...)

-- 
Ticket URL: <http://hackage.haskell.org/trac/hackage/ticket/346#comment:3>
Hackage <http://haskell.org/cabal/>
Hackage: Cabal and related projects