Comments (4)
Thanks for your advices. Yes, we need upgrade, current documentation is bad fo user.
from stylus-lang.com.
Re-organisation of the content may be needed, but what I found myself needing the most is a second-level navigation on some of the more beastly pages like BIFs - finding even the relevant section on that page is difficult - a second-level nav acting as a "table of contents" of sorts would make this way easier.
I guess the current design of the page would make it difficult to implement though.
from stylus-lang.com.
@groenroos Hi. Are you interested in stylus doc website rebuild plan? I am not mean replace current jeklly website immediately. We can create a experimental new doc site (via modern doc-gen framework and free hositing services). Maybe it's stylus.js.org
, and then collect stylus user's feedback, and deciding whether to migrate to new doc website finally(redirect stylus-lang.com
to new doc website). What's your opioion ?
I maintain
zh.mobx.js.org
andko.mobx.js.org
actually, and I have avercel
oss free plan account.
alogia-like search services is very good for enhance developer experience, and it's free for open source project
from stylus-lang.com.
@iChenLei I'm definitely interested!
For the site generation system, seems like both Docusaurus and VuePress seem to bundle React and Vue respectively, and produce a single-page application as the documentation - which I feel could be overkill for a simple docs website? Do you have in mind any specific features or enhancements either of these libraries bring or make possible, compared to more traditional / less opinionated static site generators like Jekyll or Eleventy?
Should we open a modern
branch in this project to begin working out a new frontend? Seems like the frontend/design problems are more clearly defined at the moment (#5, #14, #16, #23), so probably easier to start there. It should be possible to slot in the specific site generation technology later once we find the right solution.
I have far fewer deeply-held opinions about specific CI/deploy technologies!
And yeah, once ready, running the experimental new site in parallel would be a good idea - though do you think we can do something like new.stylus-lang.com
so Stylus' online presence doesn't fragment too much?
from stylus-lang.com.
Related Issues (20)
- Logo status HOT 11
- Optimize site for speed HOT 4
- Issues that need to be addressed before launch HOT 7
- Github icon links to LearnBoost/stylus instead of stylus/stylus HOT 2
- tweaks HOT 2
- Blast master branch HOT 1
- Cleanup design HOT 2
- Migrate Gitter to stylus/stylus HOT 1
- Make navigation on the website less vibrant HOT 3
- Negative variable
- Try Stylus not compiling valid code HOT 1
- Domain HOT 2
- sec vuln HOT 4
- stylus website underselling itself? HOT 1
- undocumented @import / @require behavior for index styling
- Overwriting variables in media queries HOT 2
- Domain renewal HOT 12
- `slice()` bif reference is markuped incorrectly HOT 2
- stylus-lang.com is not available HOT 3
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 stylus-lang.com.