Comments (4)
I've taken over the design and most behavior from YARD to not make me think about the details and first get Codo work. I agree it would be better to replace the index
with a home
to go directly to the README if there is any.
from codo.
There is currently no direct link back to the README, but the README and all other files, classes, etc. are part of the index page, so you can navigate back to the README. I'm not sure where to put the index page when the root will be the "home" (README) and decided to not change it at the moment, although I like the idea.
The root is that I'm currently very unhappy with the grown Codo code base and I really need to refactor it, introduce proper binary tree search operations and change the parsing logic from class oriented to function oriented, better decouple the template generation, provide a better default theme as a JS single page app without any frames but with integrated server that can be used on coffeedoc.info, a.s.o.
Because that's a lot of work I try to only fix bugs of exiting functionality and not introduce new or change working stuff, so I can concentrate on Codo 2.
from codo.
I totally hear you on the refactor. Don't worry about the big-picture change -- I completely understand and agree that can wait.
I'm asking to address a problem that's a bit more specific. I agree that the index has a link back to the readme, but my thought is that as a user, I don't necessarily put 2+2 together and realize that what I'm trying to get back to is the readme file. I'm just trying to get back to the homepage / "main" page.
(And that's actually honest -- it was only after your message here that I realized that (a) the index lists files too, not just classes, and (b) that README is there. I totally missed both those things as a user.)
May I suggest taking a similar approach as you do on "CoffeeDoc.info", which is to just add a new link to the homepage at the beginning of that breadcrumb bar?
[Title of Libary] >> [Index] >> Current File/Class
Sorry to pester on this -- it just feels so essential from a usability perspective. I'm finding myself repeatedly craving an easier way to return to the main page. Thanks for your consideration!
from codo.
Thanks so much! This looks great and helps a lot.
from codo.
Related Issues (20)
- Totally documented: NaN%
- Inherited @property auto link
- @abstract message display inconsistent
- @deprecated not shown in method summary
- Link to mixin method fails to parse correctly HOT 2
- Multiple possible types and linking to them HOT 2
- Can't Find Nested Functions HOT 1
- Allow forcing the name of the class HOT 15
- class properties HOT 1
- Virtual methods aren't detected HOT 1
- Properties declared using @prop_name
- Linking to classes and methods from .md files
- Parsing fails if source contains multiline string HOT 4
- error while parsing if @documentation in node_modules/codo/lib/entities/class.coffee is undefined HOT 3
- Missing `require 'winston'` statement
- Support multiline @param and @option
- Codo basedir doesn't affect relative path of inputs and extras.
- Tag New Release - Update Winston HOT 1
- TravisCI - Cannot generate documentation: Callback must be a function
- detect methods from Meteor.methods
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from codo.