Webpage information and a (practical) tour of the Xmonad Contrib in progress

Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there. Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much. The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc. byebye!

* Ismael Carnales
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
Great idea, but I'm not sure about the style. Why not just give list of modules and problems, which they solve? It would be much easier to update when new modules are released. OTOH what you're doing is more like Tips and tricks, why not to add it to apropriate page [1]? 1. http://haskell.org/haskellwiki/Xmonad/General_xmonad.hs_config_tips -- Roman I. Cheplyaka (aka Feuerbach @ IRC) http://ro-che.info/docs/xmonad.hs

Ismael Carnales wrote:
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
byebye!
I have some progress on something like this on my blog[1], what I've named the Pimp Your XMonad series of posts. The goal is to highlight cool things new users might not have known xmonad can do, and how to set them up. It grew out of the commonly seen sequence on #xmonad: <A> Can xmonad do feature X? <B> Yeah, that XMonad.Foo.Bar <A> Thanks <C> Whoa, it can do that? I never thought that might be possible. Perhaps the two should be combined in some way? Braden Shepherdson shepheb [1] http://braincrater.wordpress.com

Hehe, my original idea was inspired by your "Pimp your XMonad" series
of blog posts, so defintely we can try to do a mashup.
I started writing the draft with this in mind "what are the first
things that a person should want of XMonad after installing it and
trying", that's because statusbar is first, etc, etc. I think we
should try to follow that "logical" way, from more common tweaking to
bizarre things only to show off the power of XMonad :)
bye!
On Mon, Jan 26, 2009 at 2:58 PM, Braden Shepherdson
Ismael Carnales wrote:
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
byebye!
I have some progress on something like this on my blog[1], what I've named the Pimp Your XMonad series of posts. The goal is to highlight cool things new users might not have known xmonad can do, and how to set them up. It grew out of the commonly seen sequence on #xmonad: <A> Can xmonad do feature X? <B> Yeah, that XMonad.Foo.Bar <A> Thanks <C> Whoa, it can do that? I never thought that might be possible.
Perhaps the two should be combined in some way?
Braden Shepherdson shepheb
[1] http://braincrater.wordpress.com
_______________________________________________ xmonad mailing list xmonad@haskell.org http://www.haskell.org/mailman/listinfo/xmonad

Roman Cheplyaka wrote:
* Ismael Carnales
[2009-01-26 06:58:26-0200] Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
Great idea, but I'm not sure about the style. Why not just give list of modules and problems, which they solve? It would be much easier to update when new modules are released. OTOH what you're doing is more like Tips and tricks, why not to add it to apropriate page [1]?
1. http://haskell.org/haskellwiki/Xmonad/General_xmonad.hs_config_tips
In this vein, we also have XMonad.Doc.Extending which is a bit of a pain to keep updated. It might be nice to script generating its content from the contrib modules' initial description comments. This would make it more wordy, but possibly the automation of maintenance and extra information would be worth it. For example, for Actions.CopyWindow, the following would be generated: * "XMonad.Actions.CopyWindow": Allows you to run internal xmonad commands (X () actions) using a dmenu menu in addition to key bindings. Requires dmenu and the Dmenu XMonad.Actions module. Some module comments are much longer, so the script could use only the first paragraph rather than the whole module description. If I ever get around to trying it, will post examples for feedback before creating a patch. -- wmw

On Mon, Jan 26, 2009 at 11:58:07AM -0500, Braden Shepherdson wrote:
I have some progress on something like this on my blog[1], what I've named the Pimp Your XMonad series of posts. The goal is to highlight cool things new users might not have known xmonad can do, and how to set them up. It grew out of the commonly seen sequence on #xmonad: <A> Can xmonad do feature X? <B> Yeah, that XMonad.Foo.Bar <A> Thanks <C> Whoa, it can do that? I never thought that might be possible. [snip] [1] http://braincrater.wordpress.com
Yes, I found those posts to be helpful. When's the next one coming out? Kathryn Andersen -- _--_|\ | Kathryn Andersen http://www.katspace.com / \ | \_.--.*/ | GenFicCrit mailing list http://www.katspace.com/gen_fic_crit/ v | ------------| Melbourne -> Victoria -> Australia -> Southern Hemisphere Maranatha! | -> Earth -> Sol -> Milky Way Galaxy -> Universe

icarnales:
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
Would you like to post parts incrementally on the blog?

Yup, of course :)
On Thu, Jan 29, 2009 at 3:12 AM, Don Stewart
icarnales:
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
Would you like to post parts incrementally on the blog?

Sorry for the double posting.
Maybe can draft first the posts in the wiki (so others can help and
correct me) and then post it to the website.
bye!
On Thu, Jan 29, 2009 at 10:29 AM, Ismael Carnales
Yup, of course :)
On Thu, Jan 29, 2009 at 3:12 AM, Don Stewart
wrote: icarnales:
Hello, first I want to adress that dmenu and gmrun (both in the default keybindings and dmenu mentioned in the guided tour) are not listed as related tools in the download webpage (http://xmonad.org/download.html), i think they belong there.
Secondly I'm starting a doc that pretends to be a guided tour lookalike of some of the XMonad Contrib, I'm starting this mainly because I think it's very difficult for newcomers to discover what extra features XMonad provides. Haddock documentation is pretty useful when you know what you are looking for, but when you're looking around to find if some feature is implemented already, the way that the documentation is indexed (by alphabetical order) doesn't help much.
The in progress document is located here http://haskell.org/haskellwiki/XMonadContribTour and all are welcomed to contribute/comment/correct/etc.
Would you like to post parts incrementally on the blog?
participants (6)
-
Braden Shepherdson
-
Don Stewart
-
Ismael Carnales
-
Kathryn Andersen
-
Roman Cheplyaka
-
wirtwolff