Add info to the About page. #390
Conversation
kytrinyx
left a comment
kytrinyx
left a comment
There was a problem hiding this comment.
Thank you so much for taking the time to incorporate your changes here. I've left a few comments and suggestions, mainly for two things: general flow, and to remove some things that are probably a bit overkill in a general intro.
docs/ABOUT.md
Outdated
| @@ -1,7 +1,47 @@ | |||
| Python is a powerful programming language, it is well known as a "glue" that means: it is used with many other technologies. It is multi platform, runs everywhere. Is friendly and easy to learn. It is licensed as open source, most versions are compatible with the GPL with a few exceptions on old versions. But, one of the most cool things about Python is the community that is very helpful and collaborative. Take a look at: [About python](https://www.python.org/about/). | |||
There was a problem hiding this comment.
I think the phrase about "glue" can be omitted. Most languages are used in conjunction with other technologies. Perhaps it can be combined with the "easy to learn" bit that comes a bit later:
Python is a powerful programming language which is easy to learn.
Then "friendly" can be moved down to the bit about community.
It is multi platform, runs everywhere.
This should have an "and": It is multi-platform and runs everywhere.
Also, while I like that it mentions that it's open source, I think we can skip the details about the GPL compatibility. If someone who is wondering what Python is about or why they should learn it, they probably don't care about the nitty-gritty details of licensing. If they do care about licenses, they'll know how to look it up.
I also like that you're pointing to the community being helpful and collaborative. To read more smoothly I'd suggest changing that sentence to:
One of the coolest things about Python is the community: it is helpful, friendly and collaborative.
We don't need to link to the "about python" here, since we link to it further down.
|
|
||
| Python was started by Guido van Rossum in 1989. Its name is an homage to the comedy troupe Monty Python. Python 2 is used widely but support may end by 2020. Python 3 was introduced in 2008 and is beginning to be adopted more widely. They are similar, but users will encounter [some differences](http://blog.teamtreehouse.com/python-2-vs-python-3). Python development is shepherded by [The Python Software Foundation](https://www.python.org/about/) and there are active community-based user groups worldwide. | ||
|
|
||
| ### What python is good for? |
There was a problem hiding this comment.
If we're going to have a separate section for this, then I think we should move the "Python is used extensively" bit down as the intro to this section.
docs/ABOUT.md
Outdated
| - [Network Programming](https://www.python.org/about/apps/#network-programming) | ||
| - [Software & Game Development](https://www.python.org/about/apps/#software-development) | ||
|
|
||
| ### Who uses python? |
There was a problem hiding this comment.
I don't think we need this section—we're already linking to the about page, and if people want to know more they'll find it in that about link.
docs/ABOUT.md
Outdated
| - There are many job opportunities for Python developers in companies like Google, Yahoo!, Disney, Nokia, and IBM. Not to mention a huge amount of startups. | ||
| - It have a wide range of open source web application frameworks. | ||
|
|
||
| Python official web site [python website](https://www.python.org) and [python documentation](https://docs.python.org/) documentation to learn more. |
There was a problem hiding this comment.
This needs to be a full sentence.
|
Please take a look @kytrinyx, let me know if you have any improvement suggestions. |
|
@kytrinyx as you already took a look at this, maybe you could check it again. If you don't have enough time right know, I will read through this end of next week. |
kytrinyx
left a comment
kytrinyx
left a comment
There was a problem hiding this comment.
Overall I really like this change. It keeps the intent, while making it shorter and easier to read.
| - It have a wide range of open source web application frameworks. | ||
|
|
||
| Python official web site [python website](https://www.python.org) and [python documentation](https://docs.python.org/) documentation to learn more. | ||
| There are many job opportunities for Python developers in companies like Google, Yahoo!, Disney, Nokia, and IBM. Not to mention a huge amount of startups. It have a wide range of open source web application frameworks. Visit the Python official web site [python website](https://www.python.org) and [python documentation](https://docs.python.org/) documentation to learn more. |
There was a problem hiding this comment.
I would use "number of" instead of "amount of" when talking about startups, since startups are countable rather than measurable.
|
This issue has been automatically marked as `on hiatus because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. |
3 participants
No description provided.