[GHC] #9249: Link to "latest" user's guide
#9249: Link to "latest" user's guide ------------------------------------+------------------------------------- Reporter: goldfire | Owner: Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 7.8.2 Keywords: | Operating System: Unknown/Multiple Architecture: Unknown/Multiple | Type of failure: None/Unknown Difficulty: Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | ------------------------------------+------------------------------------- When I search (say, on Google) for a GHC-related bit of documentation, I variously get referred to old manuals. There doesn't seem to a good way for us, the GHC devs, to avoid this. But, perhaps we can include some information in the header of the pages to allow visitors to link to the latest manual, or perhaps to several versions. This header should also include the version number of the GHC that the page is documenting; currently, this info is only in the URL. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9249 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9249: Link to "latest" user's guide -------------------------------------+------------------------------------- Reporter: goldfire | Owner: Type: bug | Status: new Priority: low | Milestone: Component: | Version: 7.8.2 Documentation | Keywords: Resolution: | Architecture: Unknown/Multiple Operating System: | Difficulty: Unknown Unknown/Multiple | Blocked By: Type of failure: | Related Tickets: None/Unknown | Test Case: | Blocking: | Differential Revisions: | -------------------------------------+------------------------------------- Comment (by thomie): Similar issues for hackage: https://github.com/haskell/cabal/issues/750 https://github.com/haskell/hackage-server/issues/61#issuecomment-24742342 https://github.com/haskell/hackage-server/issues/198 There it is suggested to use canonical urls: https://support.google.com/webmasters/answer/139066?rd=1 -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9249#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9249: Link to "latest" user's guide -------------------------------------+------------------------------------- Reporter: goldfire | Owner: Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 7.8.2 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by thomie): * cc: bgamari (added) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9249#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9249: Link to "latest" user's guide -------------------------------------+------------------------------------- Reporter: goldfire | Owner: Type: bug | Status: new Priority: low | Milestone: 8.2.1 Component: Documentation | Version: 7.8.2 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * milestone: => 8.2.1 Comment: Hmm, alright, this will be a bit tricky but I think we can manage it. It will mean, however, that I'll need to rework the workflow for generating the documentation for downloads.haskell.org as currently is it simply extracted from the bindist. I'll try to have a look at doing this soon. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9249#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9249: Link to "latest" user's guide -------------------------------------+------------------------------------- Reporter: goldfire | Owner: (none) Type: bug | Status: new Priority: low | Milestone: 8.4.1 Component: Documentation | Version: 7.8.2 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by ntc2): This feature would be more useful if a link to the corresponding page in the latest documentation was included when possible, not just a link to the top level of the latest manual. I've gotten used to adding `inurl:latest` to my GHC related Google queries in order to get up-to-date result. As a simpler improvement, the header with the links could just suggest the user repeat their search with `inurl:latest` included. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9249#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC