Learn-Semantic icon indicating copy to clipboard operation
Learn-Semantic copied to clipboard

added the Beginners-Tutorial

Open HDking opened this issue 10 years ago • 12 comments

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

HDking avatar Mar 02 '15 17:03 HDking

I'll have something back to you by later this week, probably wednesday.

jlukic avatar Mar 02 '15 17:03 jlukic

I'm going to have to delay this till tomorrow, apologies.

jlukic avatar Mar 04 '15 22:03 jlukic

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.

jlukic avatar Mar 05 '15 22:03 jlukic

Great! Let us know if there is anything we can do

HDking avatar Mar 09 '15 23:03 HDking

I quite like this, it will make starting with the framework much easier for new people.

Some minor comments on the PR itself though:

  1. By placing every new sentence on a separate line you take simultaneous advantage of github (line diffs) and markdown
  2. 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:

rogierslag avatar Mar 10 '15 10:03 rogierslag

Thanks @rogierslag. I thought we added too much of those words already. . :)

HDking avatar Mar 12 '15 14:03 HDking

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):

  1. npm install semantic-ui
  2. cd semantic/
  3. edit semantic/src/theme.config (optional) [show how to know if a theme is available for a component/module]
  4. gulp build
  5. including semantic(.min).css and semantic(.min).js into a project
  6. 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

dashed avatar Jun 17 '15 01:06 dashed

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 avatar Jun 17 '15 20:06 jlukic

@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:

dashed avatar Jun 21 '15 22:06 dashed

I haven't finished writing it yet, but glad you noticed :)

Want to consolidate directions for meteor, angular, etc. as well

jlukic avatar Jun 21 '15 23:06 jlukic

What is the status of this one?

brody4hire avatar Mar 06 '18 13:03 brody4hire

@brodybits probably out of date now 😅

dashed avatar Mar 07 '18 00:03 dashed