[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread T.J. Crowder
Yes, but we're moving away from it. So a JavaScript solution would work now, and later (since I assume you're moving from Mephisto to something else that *also* supports JavaScript). If 301s work later, great, but if not there's a fallback position. A script included on each old API page that

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Tobie Langel
You're help would be really welcomed, TJ. We're moving to github pages as it makes contributing to the website the same process as contributing code or documentation. I've started the project already: porting the whole blog archives to jekyllrb and disqus comments (preserving all past comments

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Tobie Langel
Oh, the repo is here: http://github.com/sstephenson/prototype/tree/gh-pages -- You received this message because you are subscribed to the Google Groups Prototype: Core group. To post to this group, send email to prototype-core@googlegroups.com To unsubscribe from this group, send email to

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Mislav Marohnić
How about we create a prototypejs GitHub user and have the site at: prototypejs.github.com? -- You received this message because you are subscribed to the Google Groups Prototype: Core group. To post to this group, send email to prototype-core@googlegroups.com To unsubscribe from this group,

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Tobie Langel
How about we create a prototypejs GitHub user and have the site at: prototypejs.github.com? We'll be using prototypejs.org directly. It's supported by Github. -- You received this message because you are subscribed to the Google Groups Prototype: Core group. To post to this group, send email

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Tobie Langel
Enh, it's not going to take long, I'll go do that now. Awesome. I don't know if you're familiar with jekyll[1], but his sports built- in templating and markdown/textile parsers. Best, Tobie [1] http://jekyllrb.com/ -- You received this message because you are subscribed to the Google

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread T.J. Crowder
...I've written an HTML to Markdown parser:http://github.com/mislav/remark Oh, I just know that could be very handy indeed... -- T.J. :-) On Apr 8, 2:51 pm, Mislav Marohnić mislav.maroh...@gmail.com wrote: On Thu, Apr 8, 2010 at 15:11, Tobie Langel tobie.lan...@gmail.com wrote: We'll

[Prototype-core] Re: Kudos to the documentation team

2010-04-08 Thread Tobie Langel
I see. In that case, you have to ensure that old URLs are preserved. Once you're on GitHub, there will never be a chance to do 301 redirects. Are you suggesting we move the new documentation elsewhere (prototypejs.org/doc) for example and keep the old, 1.5 doc structure on prototypejs.org/api

[Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread Clint Priest
If you're on a PC you can adjust your wheel-scroll settings in Control Panel - Mouse - Wheel. I think the default is 3 and I usually adjust mine up as well. On Apr 6, 7:15 am, joe t. thooke...@gmail.com wrote: +1 for the scrolling. The navigation between documentation links has much improved,

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread toxcct
A HTTP 301 seems a better solution as it stands for Permanently redirected to a given URL... the header should look like : HTTP/1.1 301 Moved Permanently Location: http://www.newurl.com/ 2010/4/6 Tobie Langel tobie.lan...@gmail.com A practical solution would be a well designed 404. We

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread toxcct
BTW, if the .htaccess file is not accessible or cannot be updated, it is still possible to redirect from the server-side language used (header() for instance with php)... 2010/4/6 Robert Kieffer bro...@gmail.com Urm... really? You can do 404's but not 301's? Not saying I don't believe you,

[Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread T.J. Crowder
Tobie, Can we use JavaScript on Mephisto pages? -- T.J. On Apr 6, 6:49 pm, Tobie Langel tobie.lan...@gmail.com wrote: Urm... really?  You can do 404's but not 301's? I was suggesting crating a good 404 page. Not modifying the http response code. Not saying I don't believe you, I'm just

[Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread joe t.
Agreed, and it appears to be specific to Firefox. However, i can't recall any other circumstances (iframe, CSS overflow, etc) where the scroll bar behaves differently. The new API page is the only time i've seen this behavior. Peculiar. Oh well, it's hardly the end of the world. :) -joe t. On

[Prototype-core] Re: Kudos to the documentation team

2010-04-07 Thread Tobie Langel
Can we use JavaScript on Mephisto pages? -- T.J. Yes, but we're moving away from it. -- You received this message because you are subscribed to the Google Groups Prototype: Core group. To post to this group, send email to prototype-core@googlegroups.com To unsubscribe from this group, send

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Joost
I have the same problem, because I like to use google to search for stuff in the documentation but I end up on the old one. Also I think the mouse wheel scrolling in the menu on http://api.prototypejs.org is way too slow and should be fixed (it takes 10 seconds for me to scroll down with the mouse

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread T.J. Crowder
My coworkers still find old docs (http://prototypejs.org/api) by googling. I had to point them to new doc site. I think it's crucial to set up 301 redirects. *ONLY* if all of the old information has now been ported over. Looking at the documentation Lighthouse project[1], it looks like all of

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Tobie Langel
A practical solution would be a well designed 404. We could get pdoc to generate it with a search field, etc. We could also try JS redirection. Anyone wants to give it a shot? Best, Tobie On Apr 6, 8:42 am, T.J. Crowder t...@crowdersoftware.com wrote: My coworkers still find old docs

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Mislav Marohnić
On Tue, Apr 6, 2010 at 11:00, Tobie Langel tobie.lan...@gmail.com wrote: We could also try JS redirection. It would partially solve the problem, but old pages would still remain in Google index for too long a time. We should get access to the server level and set up rewrite rules or similar.

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Robert Kieffer
I disagree. 404'ing the old docs is not the correct action. 404 means not found, but the user is requesting a page that he (and you) know exists... it's just not at that location any more. Thus, a redirect is the way to go. I'd suggest the following - Move the old docs somewhere they're still

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread joe t.
+1 for the scrolling. The navigation between documentation links has much improved, but the navigation panel still has issues. The wheel- scroll is painfully slow. Even clicking in the scroll bar doesn't work as expected. When you click a position in the scroll bar, usually it jumps to where you

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Mislav Marohnić
The scroll bar is native to the browser, meaning it's the same as in a regular window, iframe or frameset. The navigation panel should scroll with same methods and speed as every window in your browser. On Tue, Apr 6, 2010 at 14:15, joe t. thooke...@gmail.com wrote: +1 for the scrolling. The

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Tobie Langel
Robert, that would be great. We unfortunately don't have this level of access to the server. -- You received this message because you are subscribed to the Google Groups Prototype: Core group. To post to this group, send email to prototype-core@googlegroups.com To unsubscribe from this group,

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Robert Kieffer
Urm... really? You can do 404's but not 301's? Not saying I don't believe you, I'm just surprised that a project as mature as prototype is hosted in an environment that doesn't support basic .htaccess-style configuration. On Tue, Apr 6, 2010 at 6:12 AM, Tobie Langel tobie.lan...@gmail.com

[Prototype-core] Re: Kudos to the documentation team

2010-04-06 Thread Tobie Langel
Urm... really?  You can do 404's but not 301's? I was suggesting crating a good 404 page. Not modifying the http response code. Not saying I don't believe you, I'm just surprised that a project as mature as prototype is hosted in an environment that doesn't support basic .htaccess-style

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-05 Thread Johan Arensman
Wow! I didn't even realise they were updated until I read this message. Very nice work indeed! On Sat, Apr 3, 2010 at 2:56 PM, Clint Priest cpri...@warpmail.net wrote: I would definitely second that, great work! On Apr 3, 1:32 am, T.J. Crowder t...@crowdersoftware.com wrote: The new docs

Re: [Prototype-core] Re: Kudos to the documentation team

2010-04-05 Thread Mislav Marohnić
On Mon, Apr 5, 2010 at 11:48, Johan Arensman johanm...@gmail.com wrote: Wow! I didn't even realise they were updated until I read this message. Very nice work indeed! My coworkers still find old docs (http://prototypejs.org/api) by googling. I had to point them to new doc site. I think it's

[Prototype-core] Re: Kudos to the documentation team

2010-04-03 Thread Clint Priest
I would definitely second that, great work! On Apr 3, 1:32 am, T.J. Crowder t...@crowdersoftware.com wrote: The new docs Andrew pushed yesterday are a HUGE leap forward! Well done to everyone who contributed to both the content and the improved linkability and such. Major kudos! -- T.J. :-)