search

yiisoft-contrib / yiiframework.com

Source code for official Yii website
http://yiiframework.com/
Other
261 stars 100 forks source link

Getting started and entry points #49

Open cebe opened 9 years ago

cebe commented 9 years ago

Linking to the guide is not enough imo.

For "Getting started" there are basically two different entry points:

  1. install yii and get a working basic app as soon as possible
  2. know about what you need to know and learn and where to find help to get a deep understanding of yii

here is how we have these on IRC:

(23:05:38) CeBe: !faq start (23:05:39) MrFisk: CeBe: 1) To get started with Yii 2, please read: http://www.yiiframework.com/doc-2.0/guide-README.html#getting-started 2) To learn more, please read the Yii 2 Guide: http://www.yiiframework.com/doc-2.0/guide-README.html 3) Get to know the API docs at http://www.yiiframework.com/doc-2.0/ - you'll use them every day. You can view Yii source code directly in the API docs. The API search box is invaluable.

(23:05:43) CeBe: !faq learn (23:05:43) MrFisk: CeBe: Here is a step by step To-Do list for Yii beginners. The list is an advice of what tutorials and documentation you can walk through to get a full understanding of the Yii Framework. These can be a help to learn Yii. http://www.yiiframework.com/wiki/268/how-to-learn-yii

samdark commented 9 years ago

Introduced new page.

samdark commented 9 years ago

Need more suggestions on content.

jacmoe commented 8 years ago

I have started to work - or think - on the getting started page.. yiisite9 ((Don't worry too much about that code block, it was just a test of the highlight widget..))

That is meant as an appetizer. A fun, informative one that shows how a typical work flow would go: composer and fxp installation, project generation, server setup and test drive of new site, migrations (to add a comments table) and Gii to quickly create CRUD so that the comments can be added/deleted/edited/viewed.. The images are not meant to be viewed, they are backgrounds, and the information should be short and give links to more info. Just a teaser.

The other page, 'Install Yii', could be a page where the various ways of getting Yii installed is dealt with, from composer create-project, composer require, manual download and configuration, introducing project templates, etc. And provide gateways to the docs.

samdark commented 8 years ago

Great idea.

mdomba commented 8 years ago

agree with sam... it's a great idea

SilverFire commented 8 years ago

I like it too

jacmoe commented 8 years ago

I hope that you still like it after I had to take the blue lines out and simplify it - it just didn't work on smaller devices: yiisite2

samdark commented 8 years ago

Without blue lines it's not as charming but the idea is still great.

jacmoe commented 8 years ago

I'll see what I can do :)

jacmoe commented 8 years ago

yiisite3

81

Needs to be adjusted, but that should wait until the content has been fleshed out.

cebe commented 8 years ago

@jacmoe I've added you as a colaborator to the repository. You can now directly push to master branch.

jacmoe commented 8 years ago

Great:) I'll do my best to honor the trust.