http://forums.leaflabs.com/topic.php?id=544 A place to share, learn, and grow... en-US Fri, 22 Jan 2016 00:06:16 +0000 http://bbpress.org/?v=1.0.2 q http://forums.leaflabs.com/search.php http://forums.leaflabs.com/topic.php?id=544&page=2#post-3175 Tue, 21 Dec 2010 02:20:46 +0000 mbolivar 3175@http://forums.leaflabs.com/ <p>re: the paragraph symbol,</p> <p>That's Sphinx's (the documentation generator we use) default behavior; here's an example page from the Python docs which does the same thing:<br /> <a href="http://docs.python.org/release/2.6.5/library/os.html" rel="nofollow">http://docs.python.org/release/2.6.5/library/os.html</a></p> <p>As you've likely discovered, the paragraph heading is a link, which when clicked, takes you to an HTML anchor for the section. AFAICT the mechanism is intended to enable getting permalinks to sections without having a TOC at the beginning of every page. It's never bothered me personally, but I can see why it would be frustrating.</p> <p>I've looked at the raw HTML, and the paragraph symbols are there, so it should be possible to redo the CSS, add some javascript, or something to keep that capability without having content appear and disappear, but it would take a little while for me to figure it out. I'm not much good with Web 2.0 design.</p> <p>I will look into it, but I won't make you any promises about when a fix might get put in, given that it's not really what I'm good at. </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-3140 Wed, 15 Dec 2010 18:21:36 +0000 gbulmer 3140@http://forums.leaflabs.com/ <p>A small suggestion - is it possible to <strong>stop</strong> the paragraph symbol from appearing when my cursor sweeps over a heading? </p> <p>For example:<br /> <a href="http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/bootloader.html#maple-rev6-the-serial-bootloader-tentative" rel="nofollow">http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/bootloader.html#maple-rev6-the-serial-bootloader-tentative</a></p> <p>I keep thinking something happened, and going back to see what happened. </p> <p>{start rant:<br /> IMHO it is drivel. It is the opposite of good visual design. Why on earth a dumb heading should attract attention is beyond me. It is pure nonsense. The sort of rubbish that visually-illiterate technologists do because they don't realise there is such a thing as taste or graphic design; the sort of folks who think that text should look 'exciting', even if it serves no useful purpose.<br /> end rant} </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-3135 Wed, 15 Dec 2010 07:04:38 +0000 mbolivar 3135@http://forums.leaflabs.com/ <p>gbulmer -- many thanks. i'll fix this before 0.0.9 comes out today. </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-3114 Mon, 13 Dec 2010 17:34:34 +0000 gbulmer 3114@http://forums.leaflabs.com/ <p>There are some very serious errors in:<br /> <a href="http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/analogread.html#discussion" rel="nofollow">http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/analogread.html#discussion</a></p> <blockquote><p>It takes about 0.8 microseconds (.0000008 seconds) to read an analog input, so the maximum sample rate using this function is approximately 1.3 million samples per second[1] </p></blockquote> <p>That isn't true. With a perfect configuration, using a system clock of 56MHz, enabling an ADC clock at its maximum of 14MHz, it takes, at least, 1 microseconds to read an analog input. The conversion time is further extended by sample time, which is 55.5 cycles of the ADC clock.</p> <p>At <a href="http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/analogread.html#fsamp" rel="nofollow">http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/analogread.html#fsamp</a></p> <blockquote><p>This is based on the current configuration of a 55.5 cycle sample time, at 72 MHz. However, the minimum sample time possible is 1.5 cycles, leading to a theoretical maximum of approximately 48 million samples per second (of course, doing anything with the readings also consumes cycles, so this maximum can’t be reached in practice). </p></blockquote> <p>1 microsecond would be based on the minimum of 14 cycles of a 14MHz ADC clock. The processor clock is divided down to get the ADC clock, it isn't used directly.<br /> AFAIK, the actual time with the current setup is about 68 cycles of 12 MHz. </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-2913 Wed, 01 Dec 2010 14:41:03 +0000 poslathian 2913@http://forums.leaflabs.com/ <p>Thanks for all the great feedback. Now that we have a good foundation to build off of, it seems the steps forward for making the docs even better are really starting to pop out. Whereas before, the best idea for how to improve the docs was...uhh.."can you make it better?"</p> <p>Well they were made better, and let me take this opportunity to publicly thank Mbolivar for putting these new docs together...put the credit where its due - which is pretty squarely on his shoulders. Awesome job and thanks! </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-2901 Tue, 30 Nov 2010 22:27:46 +0000 gbulmer 2901@http://forums.leaflabs.com/ <p>A few comments on<br /> <a href="http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/language.html" rel="nofollow">http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/language.html</a></p> <p>Maybe move the "Note for C/C++ Programmers" to a separate page?<br /> It is very interesting information, but IMHO the language reference page would be more focused if it was, erm, well, er, more focused!?</p> <p>If the side bar is staying, delete the "Contents" block from the page flow.</p> <p>Then the page could start with the "Maple Language Reference" table.</p> <p>I'd suggest putting ASSERT into the table, maybe in a 'debug" section?</p> <p>I'd also suggest putting in everything from the Arduino 'standard' library/language, and marking things that are not implemented.</p> <p>For example:<br /> "word" in data types, and say "not implemented" - it can have a link to a section lower down the page for an explanation.<br /> "analogReference()" - "not implemented" and a link<br /> Similarly:<br /> * interrupts()<br /> * noInterrupts()<br /> * noTone()<br /> * pulseIn()<br /> * shiftOut()<br /> * String<br /> * tone()</p> <p>Put them in the Language Reference table, in the appropriate section, and mark which aren't there yet.</p> <p>I'd suggest making a small icon for "not implemented" to ensure the table can be kept compact (the Leafab logo combined with the classic 'stop' sign?).<br /> You might also think about differentiating between functionality on Maple Native, but not Maple; again a small icon?</p> <p>Personally, I'd like to be able to see at a glance which items in the table are just standard C/C++, and which are Maple/Arduino. I'd never bother reading any of the C/C++ linked pages (but others might), but I would want to look at the non-C/C++ standard things, which are mainly the library, a few constants, and typedefs.</p> <p>There are a bunch of constants missing, from pinMode, which I'd prefer to see on the reference page, listed under constants, or under pinMode.</p> <p>There are a bunch of integer types which I'd like to see listed in the reference: uint8, int8, uint16, int16, etc. They don't need to be one per line, or they could be alises of the actual type and listed alongside them.</p> <p>There is some ambiguity about what is a language element, e.g. OUTPUT, and a language concept, e.g. a "Constant". One I can type into a program, and it compiles, the other is not.</p> <p>IMHO there needs to be a clearer way to differentate between them. This applies to Array and Numeric types too. If you feel the need for Numeric Types use it as a sub heading, and put them all under it. </p> <p>Strings needs work.<br /> The C++ class is String, and that could be in the list of data types.<br /> The concept of a C string is covered in the page <a href="http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/string.html#lang-string" rel="nofollow">http://static.leaflabs.com/pub/leaflabs/maple-docs/docs-0.0.9-preview/lang/string.html#lang-string</a><br /> Maybe call it 'C character string', or use the Arduino reference "string - char array"?</p> <p>HTH </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-2899 Tue, 30 Nov 2010 20:08:59 +0000 hanna 2899@http://forums.leaflabs.com/ <p>Well, it turns out that the collapsible sidebar only works on the left, so the sidebar may be moving back. I do really like it on the right though :( </p> http://forums.leaflabs.com/topic.php?id=544&page=2#post-2897 Tue, 30 Nov 2010 18:58:51 +0000 mbolivar 2897@http://forums.leaflabs.com/ <p>it takes some getting used to, but it's grown on me. sphinx uses a similar style for their own docs, and it seems to work:<br /> <a href="http://sphinx.pocoo.org/contents.html" rel="nofollow">http://sphinx.pocoo.org/contents.html</a> </p> http://forums.leaflabs.com/topic.php?id=544#post-2895 Tue, 30 Nov 2010 18:47:04 +0000 crenn 2895@http://forums.leaflabs.com/ <p>Hanna, I'm not saying the sidebar is a bad idea, I'm saying it looks strange on the right to me. </p> http://forums.leaflabs.com/topic.php?id=544#post-2893 Tue, 30 Nov 2010 18:10:04 +0000 hanna 2893@http://forums.leaflabs.com/ <p>crenn -- I've been putting together the restyle. I can't stand having to go back to a separate table of contents page all the time when I'm looking at documentation, so I'm definitely a fan of the sidebar. I hope you (and other sidebar naysayers) grow to like it, but I'll look into making it collapsable anyway.</p> <p>larryang -- I'll do what I can, but it's going to be hard to round anything out without writing a new template all together. I tried to soften it up by handpicking friendly fonts. Please let me know if you have any more ideas for making the interface less harsh. </p> <p>I'm the newest member of LeafLabs by the way. It's nice to meet you all! </p> http://forums.leaflabs.com/topic.php?id=544#post-2890 Tue, 30 Nov 2010 13:41:59 +0000 mbolivar 2890@http://forums.leaflabs.com/ <p>larryang -- yeah, that's a good idea. </p> http://forums.leaflabs.com/topic.php?id=544#post-2889 Tue, 30 Nov 2010 10:19:48 +0000 larryang 2889@http://forums.leaflabs.com/ <p>I would round some of the corners (that seems be the trend nowadays). Makes it feel less, um, harsh. Color scheme works for me. </p> http://forums.leaflabs.com/topic.php?id=544#post-2887 Tue, 30 Nov 2010 09:25:43 +0000 crenn 2887@http://forums.leaflabs.com/ <p>To me it looks a little strange, but that's all. </p> http://forums.leaflabs.com/topic.php?id=544#post-2886 Tue, 30 Nov 2010 09:09:52 +0000 mbolivar 2886@http://forums.leaflabs.com/ <p>i think it's just where the theme we're customizing puts it (not sure; i didn't do the theming), but i think it's nicer there. </p> http://forums.leaflabs.com/topic.php?id=544#post-2885 Tue, 30 Nov 2010 04:15:40 +0000 crenn 2885@http://forums.leaflabs.com/ <p>The restyle looks pretty good, curious why the side bad is now on the right. </p>