Re: [GHC] #1064: Allow users to add commentary to Haddock docs

[GHC]

#1064: Allow users to add commentary to Haddock docs
---+
  Reporter:  simonpj   |  Owner:  
  Type:  task  | Status:  closed  
  Priority:  normal|  Milestone:  Not GHC 
 Component:  None  |Version:  
Resolution:  wontfix   |   Keywords:  
  Testcase:|  Blockedby:  
Difficulty:  Unknown   | Os:  Unknown/Multiple
  Blocking:|   Architecture:  Unknown/Multiple
   Failure:  None/Unknown  |  
---+
Changes (by igloo):

  * status:  new => closed
  * failure:  => None/Unknown
  * resolution:  => wontfix


Comment:

 I've added the above to the haddock ticket on the same subject:
 http://trac.haskell.org/haddock/ticket/72#comment:5

-- 
Ticket URL: 
GHC 
The Glasgow Haskell Compiler

___
Glasgow-haskell-bugs mailing list
Glasgow-haskell-bugs@haskell.org
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs

Re: [GHC] #1064: Allow users to add commentary to Haddock docs

[GHC]

#1064: Allow users to add commentary to Haddock docs
-+--
 Reporter:  simonpj  |  Owner: 
 Type:  task | Status:  new
 Priority:  normal   |  Milestone:  Not GHC
Component:  None |Version: 
 Severity:  normal   | Resolution: 
 Keywords:   | Difficulty:  Unknown
 Testcase:   |   Architecture:  Unknown
   Os:  Unknown  |  
-+--
Changes (by PHO):

 * cc: [EMAIL PROTECTED] (added)

-- 
Ticket URL: 
GHC 
The Glasgow Haskell Compiler___
Glasgow-haskell-bugs mailing list
Glasgow-haskell-bugs@haskell.org
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs

[GHC] #1064: Allow users to add commentary to Haddock docs

[GHC]

#1064: Allow users to add commentary to Haddock docs
+---
Reporter:  simonpj  |   Owner: 
Type:  task |  Status:  new
Priority:  normal   |   Milestone:  Not GHC
   Component:  None | Version: 
Severity:  normal   |Keywords: 
  Difficulty:  Unknown  |Testcase: 
Architecture:  Unknown  |  Os:  Unknown
+---
It would be great if Haddock generated web pages that allowed '''users'''
 to add commentary to the documentation.   That would make it much more
 interactive.  The PHP manual does this, to good effect
 http://blog.milkfarmsoft.com/?p=29

 In fact, Haddock already supports something like this.  It has a flag that
 adds a Wiki link to every function definition; users can click on the link
 to get to a Wiki page that they can then add material to.  But it's not
 perfect:

  * Most of the Wiki links will be empty, but there's no way to tell that
 when looking at the link.  It'd be better to highlight populated links
 somehow.
  * The library author may want to look at all the comments for a module,
 with a view to enhancing the Haddock docs; but it would be unbearably
 tedious to go through them all one by one.
  * There is no place for overall comments


 There is real potential here, but it needs someone to think about it, and
 implement something a bit better.

-- 
Ticket URL: 
GHC 
The Glasgow Haskell Compiler___
Glasgow-haskell-bugs mailing list
Glasgow-haskell-bugs@haskell.org
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs