On 01/12/2013 08:53, Jan Stolarek wrote:
Herbert, Austin,

right, I didn't notice link to Newcomers is on the "Working on GHC" page. I 
rearranged it slightly
by reversing first three steps. So link to Newcomers is now first on the list 
and I think it
might stay that way. Link to "Working on GHC" is also in the second paragraph 
of the main wiki
page, so I think we're good.

As for the sidebar I'm using it on a regular basis although I feel some links 
could be removed:
Documentation -> Repositories; Debugging; View Tickets -> By Milestone; By OS; 
By Architecture;
But that's only my opinion - I'm CCing ghc-devs so others can chime in. If we 
could somehow track
how often each link is used that could be a valuable information. Not sure if 
it can be done.

The problem with Repositories is that it doesn't live under one of the 4 main hierarchies (Building, Commentary, Debugging, WorkingConventions), so finding it is a bit tricky. I've just added a link to it from the top WorkingConventions page so that should help. I think perhaps it ought to be moved under WorkingConventions/Repositories.

I don't know about other people, but the way I most commonly query tickets is from the Roadmap page: pick a milestone and click on "active tickets".

Cheers,
Simon



Janek

Dnia niedziela, 1 grudnia 2013, Herbert Valerio Riedel napisaƂ:
On 2013-12-01 at 09:00:21 +0100, Jan Stolarek wrote:
perhaps a direct link in the sidebar or maybe even a link on the front
page in Developer Documentation section would be appropriate!

I added link to Newcomers page at the main page of Commentary.

btw, I'm confused a bit... there's already a rather obvious

"Joining In"->"Working on GHC" link in the side-bar, which points to

   https://ghc.haskell.org/trac/ghc/wiki/WorkingConventions

which then points you to the steps that are expected from newcomers,
including the 'Newcomers' page as the 3rd step; once could maybe just
add more emphasis to the 3rd step so that it visually stands out better
(e.g. via [2] or [3])

I'm just worried that cluttering the side-bar[1] with a redundant link
may make it less useful.

Don't have the permissions to add it to the sidebar though.

...the reason is btw, that it's a hacked in HTML fragment that's part of
the custom Trac stylesheet mod for GHC; it can't be edited via the
web-UI.



  [1]: which, personally, I find kinda overloaded and redundant which
       makes me wonder if it's really that useful in its current form;


  [2]: https://ghc.haskell.org/trac/ghc/wiki/WikiBoxes

  [3]: https://ghc.haskell.org/trac/ghc/wiki/WikiIcons


_______________________________________________
ghc-devs mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/ghc-devs

_______________________________________________
ghc-devs mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/ghc-devs

Reply via email to