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. 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;