search

Active-CSS / active-css

The epic event-driven browser language for UI with functionality in one-liner CSS. Over 100 incredible CSS commands for DOM manipulation, ajax, reactive variables, single-page application routing, and lots more. Could CSS be the JavaScript framework of the future?
https://activecss.org
Other
42 stars 7 forks source link

Set up a new documentation website #284

Closed bob2517 closed 6 months ago

bob2517 commented 1 year ago

The current documentation website is getting a bit large, and it's way too wordy. It's quick to find things, but you have to know where to go. And there are techniques for doing things which are only implied if you know the full syntax. New documentation methods are desperately needed. The ACSS behind it is version 1 and could do with an upgrade. The HTML and CSS on the site is not very clean or clever. There are no fancy page transitions, so we're missing a trick on demonstrating ACSS's inherent and largely under-documented SPA capabilities. It doesn't have a proper pro feel to it.

Make a new website that makes it simpler for new and existing devs to grasp concepts. Involve a pro graphic designer (not a web designer) with prototyping and do a number on it just like a work project. Add any necessary animation, etc., to make concepts clearer. Keep it on self-hosted servers so full flexibility and ownership in kept intact.

dragontheory commented 1 year ago

Hey there, I would love an opportunity to help out any way I can.

I can prototype something for you, if you like.

No pressure, totally cool either way.

Let me know.

On Thu, Oct 6, 2022, 7:35 AM Rob Galbraith @.***> wrote:

The current documentation website is getting a bit large, and it's way too wordy. It's quick to find things, but you have to know where to go. And there are techniques for doing things which are only implied if you know the full syntax. New documentation methods are desperately needed.

Make a new website that makes it simpler for new and existing devs to grasp concepts. Involve a pro graphic designer with prototyping and do a number on it just like a work project. Keep it on self-hosted servers so full flexibility in kept intact.

— Reply to this email directly, view it on GitHub https://github.com/Active-CSS/active-css/issues/284, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAATWYENX3ASPYJHELBLSK3WB22KPANCNFSM6AAAAAAQ6QQGT4 . You are receiving this because you are subscribed to this thread.Message ID: @.***>

bob2517 commented 1 year ago

That's very kind of you, but I've already agreed terms with a graphic designer from my workplace.

I do need to get the code editor re-designed though, and that was not part of the deal with this guy. Would that be something you would be interested in helping on? If not, that's ok. The current design of it is very blocky and I've seen better ones around, but I'm no designer :) It's not an immediate thing though - I probably won't be starting on this for a couple of months.

dragontheory commented 1 year ago

Absolutely! Anything I can do to help. I will start the "due diligence" research and look around to see what others are doing such as MDN and the like.

bob2517 commented 1 year ago

That would be awesome, thank you! :)