Much more complete landing page

1 view
Skip to first unread message

Cyrus Omar

unread,
May 27, 2010, 3:49:11 PM5/27/10
to ahh-d...@googlegroups.com
I made a much better landing page for ahh, let me know what you think:

http://ahh.bitbucket.org/doc/build/html/index.html

Also, can we figure out how to get rid of that redirect page when you go to ahh.bitbucket.org?

Michael Rule

unread,
May 27, 2010, 3:57:27 PM5/27/10
to ahh-d...@googlegroups.com
I think its quite nice, I am quite impressed by the sheer volume of
code and documentation you have generated. I don't really have any
tips besides maybe trying to pay a web design / CMU art student to
redo the whole site design, but thats probably excessive. I only
skimmed it but I didn't see anything glaringly wrong, and can't think
of anything missing. The only other thing I can think of is make it
easier for users to create documentation through a wiki structure like
PyCUDA, but, no users yet.

I don't know what to do about the re-direct. options :
-- make the redirect sexier, as in, matching color scheme and less
visible ( its up for 0.1s )
-- move the info page to where the re-direct is and hand maintain all the links
-- create a general project landing page

> --
> You received this message because you are subscribed to the Google Groups
> "ahh-discuss" group.
> To post to this group, send email to ahh-d...@googlegroups.com.
> To unsubscribe from this group, send email to
> ahh-discuss...@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/ahh-discuss?hl=en.
>

Cyrus Omar

unread,
May 27, 2010, 5:14:23 PM5/27/10
to ahh-d...@googlegroups.com
There is a wiki that comes with bitbucket that we can refer people to, the way Andreas does. I should also mention the contrib directories (and possibly include them in the documentation generator.)

I'll see if I can figure out how to get sphinx to put index.html into some other place. I feel like I saw that capability at some point.

Cyrus

Cyrus Omar

unread,
May 27, 2010, 5:17:34 PM5/27/10
to ahh-d...@googlegroups.com
Also the site design is fine with me. I like the logo. Maybe the colors and margins could use some tweaking for the main text. I don't have any money to pay anyone though, so that'll have to wait until someone feels like doing it.

Cyrus Omar

unread,
May 27, 2010, 6:55:48 PM5/27/10
to ahh-d...@googlegroups.com
I thoroughly reviewed ahh.cl's docstrings so that module is looking good now, let me know if anyone finds any problems with it. The other modules still need to undergo revision. Note that all of the documentation refers to the cl.oquence branch at the moment, which I will merge soon.

I'm also building a PDF version of the documentation, http://ahh.bitbucket.org/doc/build/latex/ahh.documentation.pdf.  I don't know how to fix that little bug at the bottom of the table of contents, but everything else looks pretty good.

Cyrus

Rick Gerkin

unread,
May 27, 2010, 11:15:43 PM5/27/10
to ahh-d...@googlegroups.com
It looks exactly like a Python documentation page should look.  I won't generate my first objections until I have my first unanswered questions about using ahh.  

Someone needs to write a gmail plugin that deletes all higher-than-first-order quoted text in a reply.  In an era of threaded mail clients, its not necessary for us to be carrying the entire thread in every message.  I need the last person's original contributions quoted for context blocks, and the rest discarded.   
Richard C. Gerkin
Postdoctoral Fellow, Dept. of Biological Sciences
Carnegie Mellon University

Cyrus Omar

unread,
May 28, 2010, 11:43:35 AM5/28/10
to ahh-d...@googlegroups.com
Not everyone's email client saves the thread I guess.

I'll be working on documentation and examples for cl.oquence today (and probably squashing bugs / adding missing things), so probably next week anyone who wants to play with it should be able to do so without trouble (you can try today but no promises). I'll keep the list updated on the progress.

Cyrus
Reply all
Reply to author
Forward
0 new messages