Skip to content

Add info to the About page.#390

Closed
ramiroluz wants to merge 2 commits into
exercism:masterfrom
ramiroluz:master
Closed

Add info to the About page.#390
ramiroluz wants to merge 2 commits into
exercism:masterfrom
ramiroluz:master

Conversation

@ramiroluz

Copy link
Copy Markdown

No description provided.

@ramiroluz ramiroluz mentioned this pull request Oct 28, 2016

@kytrinyx kytrinyx left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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.

Comment thread 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/).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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.

Comment thread docs/ABOUT.md

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?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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.

Comment thread 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?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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.

Comment thread 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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This needs to be a full sentence.

@ramiroluz

Copy link
Copy Markdown
Author

Please take a look @kytrinyx, let me know if you have any improvement suggestions.

@behrtam

behrtam commented Mar 19, 2017

Copy link
Copy Markdown
Contributor

@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 kytrinyx left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Overall I really like this change. It keeps the intent, while making it shorter and easier to read.

Comment thread docs/ABOUT.md
- 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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would use "number of" instead of "amount of" when talking about startups, since startups are countable rather than measurable.

@stale stale Bot added the on hiatus label May 6, 2017
@stale

stale Bot commented May 6, 2017

Copy link
Copy Markdown

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.

@stale stale Bot closed this Jul 13, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants