[ocaml-platform] Wireframe demo of OCaml.og

Amir Chaudhry amc79 at cam.ac.uk
Fri Mar 15 08:48:08 GMT 2013


--
sent via mobile

On 15 Mar 2013, at 05:54, Daniel Bünzli <daniel.buenzli at erratique.ch> wrote:

> Hello,
> 
>> On wider monitors, we'd likely add more whitespace either side so as to avoid stretching the content too far.
> 
> W.r.t. page layout stretchability but on the narrower side, a good test to have in mind is to check if on a laptop you can have an 80-columns text editor and the documentation side by side without needing horizontal scrolling.

Hadn't thought of that so I'll bear it in mind. However, it may still depend on the resolution of the laptop in question (eg I have a 'retina' MacBook which has more horizontal space than my old laptop). 


> Regarding the Modules tab I'm not sure I understood you well so it may already be the idea. But if the package has a single module it would be nice if it shows directly the documentation of that module to save one useless click. 

Yes, that's the plan. I did mention it but probably wasn't clear enough.


> Also, it's more a comment for opam, but it would be nice if the documentation system could do the same locally with the same experience but showing you only the documentation of your installed packages (with a landing page that lists the packages and their respective modules for direct access).

Yes, this is also something we want :)  It's not just an opam thing as it involves Leo's upcoming work on documentation, as well as using packages like cow, opam2web, weberizer etc. Doing this locally, would enable the creation of properly cross-referenced docs for a particular user's environment. 

Best wishes,
Amir

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ocaml.org/pipermail/platform/attachments/20130315/44d5e9e4/attachment-0001.html>


More information about the Platform mailing list