Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

#

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Jump to bottom

added the Beginners-Tutorial #12

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

added the Beginners-Tutorial #12

wants to merge 3 commits into from

Conversation

HDking
Copy link

@HDking HDking commented Mar 2, 2015

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

@phuckien phuckien mentioned this pull request Mar 2, 2015
Open
@jlukic
Copy link
Member

jlukic commented Mar 2, 2015

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

@jlukic
Copy link
Member

jlukic commented Mar 4, 2015

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

jlukic added a commit that referenced this pull request Mar 5, 2015
@jlukic
Moving files to proper locations #12
c57082c
jlukic added a commit that referenced this pull request Mar 5, 2015
@jlukic
Fix image links #12
a104240
jlukic added a commit that referenced this pull request Mar 5, 2015
@jlukic
Beginning formatting and edits #12
a28af1c
jlukic added a commit that referenced this pull request Mar 5, 2015
@jlukic
Header structure #12
ff34404
@jlukic
Copy link
Member

jlukic commented Mar 5, 2015

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.

@HDking
Copy link
Author

HDking commented Mar 9, 2015

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

@rogierslag
Copy link

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

👍

@HDking
Copy link
Author

HDking commented Mar 12, 2015

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

HDking and others added 2 commits March 18, 2015 10:07
@HDking
Update Beginners guide.md
7b0b582 
Based on the feedback received I've updated the beginners guide.
@jellelicht
Merge pull request #1 from HDking/Additions-beginners-guide
a4afb5f 
Update Beginners guide.md
dashed
dashed reviewed Jun 17, 2015
View reviewed changes
Beginners-Tutorial/Beginners guide.md


```
<html>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add <!DOCTYPE html>

@dashed
Copy link

dashed commented Jun 17, 2015

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:

@jlukic
Copy link
Member

jlukic commented Jun 17, 2015

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.

@dashed
Copy link

dashed commented Jun 21, 2015

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

@jlukic
Copy link
Member

jlukic commented Jun 21, 2015

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

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

@brody4hire
Copy link

What is the status of this one?

@dashed
Copy link

dashed commented Mar 7, 2018

@brodybits probably out of date now 😅

# for free to join this conversation on GitHub. Already have an account? # to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
enhancement
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
6 participants
@HDking @jlukic @rogierslag @dashed @brody4hire @jellelicht