Learn-Semantic
Learn-Semantic copied to clipboard
added the Beginners-Tutorial
Hi Jack,
Hereby our first draft for the beginners tutorial as promised in issue #1571. We hope sincerely that our pull request is worth merging into your Learn Semantic repo!
Kind regards, @phuckien, @evanderschrier, @wordempire and @HDking
Our teaching staff: @avandeursen @rogierslag
I'll have something back to you by later this week, probably wednesday.
I'm going to have to delay this till tomorrow, apologies.
Everything is good, I just need to finish editing the copy and converting over some of the styles to fit into the docs.
On a side note I've updated the homepage on www.semantic-ui.com to help give a better introduction to the lib.
Great! Let us know if there is anything we can do
I quite like this, it will make starting with the framework much easier for new people.
Some minor comments on the PR itself though:
- By placing every new sentence on a separate line you take simultaneous advantage of github (line diffs) and markdown
- In some points, try to make the language more enthusiastic. Eg, tell the user they are doing great: it's the first time they are working with the framework, so offering some compliments might work quite well
:+1:
Thanks @rogierslag. I thought we added too much of those words already. . :)
This guide is okay-ish. I think there's way too much hand-holding which detracts the purpose of a beginner's guide. The screenshots of what the text editor looks like is totally unnecessary which could be left to markdown code blocks.
As a "beginner" to semantic-ui, but an experienced webdev, I like to see various guides to bootstrapping, which seem to be missing from here: http://learnsemantic.com/guide/expert.html#workflow
The npm and gulp method should be incorporated into this PR (since none of these steps seem be written anywhere):
-
npm install semantic-ui
-
cd semantic/
- edit
semantic/src/theme.config
(optional) [show how to know if a theme is available for a component/module] -
gulp build
- including
semantic(.min).css
andsemantic(.min).js
into a project - include tutorial detailed in this PR
Replace steps 1-5 with other various bootstrapping:
- downloading distributable sources
- CSS/LESS/other versions i.e. https://github.com/Semantic-Org/Semantic-UI#additional-versions
I'm going to use those exact steps in the getting started guide i'm publishing to semantic-ui.com.
The schism between learn-semantic and the main site is a bit confusing, so i'm going to try my best to include all essential guides in the main docs.
@jlukic Just saw this: http://beta.semantic-ui.com/introduction/getting-started.html I'm guesing it's still being worked on, as I see no direct link to it. But it seems sufficient enough :+1:
I haven't finished writing it yet, but glad you noticed :)
Want to consolidate directions for meteor, angular, etc. as well
What is the status of this one?
@brodybits probably out of date now 😅