Skip to content

Rephrasing some sentences in the README #202

New issue

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

Sign up for GitHub

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

Already on GitHub? Sign in to your account

Merged
ftomassetti merged 2 commits into from
Nov 18, 2015
Merged

Rephrasing some sentences in the README #202

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
07246de
Rephrasing some things in the README.
tcld Nov 17, 2015
29867a2
Further refinements.
tcld Nov 18, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ WorldEngine - a world generator

_The current stable version is 0.18.0_

You can generate worlds data (heighmap, biome, etc.) and images for your own worlds.
You can generate your own world, including images (heigthmap, biomes, etc.).

@ftomassetti ftomassetti Nov 17, 2015

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 underline that there is data produced: the images are a showcase to lure the user but the product is the data imho


For example:

Expand All @@ -15,9 +15,9 @@ worldengine world -s 1 -n seed1

Worlds are generated using plate simulations, erosion, rain shadows, Holdridge life zones model and plenty of other phenomenons.

Once a world it can be used for simulation civs evolution (see project [civs](https://github.com/ftomassetti/civs)).
A finished world can be used for simulating the evolution of a civilization (see project [civs](https://github.com/ftomassetti/civs)).

@ftomassetti ftomassetti Nov 17, 2015

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.

"A finished world" sounds weird to me

@toddcarnes toddcarnes Nov 17, 2015

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

"A finished world" is fine. In fact it's much better than his or read
before.
On Nov 17, 2015 14:41, "Federico Tomassetti" notifications@github.com
wrote:

In README.md
#202 (comment):

@@ -15,9 +15,9 @@ worldengine world -s 1 -n seed1

Worlds are generated using plate simulations, erosion, rain shadows, Holdridge life zones model and plenty of other phenomenons.

-Once a world it can be used for simulation civs evolution (see project civs).
+A finished world can be used for simulating the evolution of a civilization (see project civs).

"A finished world" sounds weird to me

—
Reply to this email directly or view it on GitHub
https://github.com/Mindwerks/worldengine/pull/202/files#r45133722.

@ftomassetti ftomassetti Nov 17, 2015

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.

Good then, I defer to the wisdom of native speaker :)

@toddcarnes toddcarnes Nov 17, 2015

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Or, you could just leave the word "finished" out, if you want to, and it
will still sound a lot better than the original.
On Nov 17, 2015 14:53, "Federico Tomassetti" notifications@github.com
wrote:

In README.md
#202 (comment):

@@ -15,9 +15,9 @@ worldengine world -s 1 -n seed1

Worlds are generated using plate simulations, erosion, rain shadows, Holdridge life zones model and plenty of other phenomenons.

-Once a world it can be used for simulation civs evolution (see project civs).
+A finished world can be used for simulating the evolution of a civilization (see project civs).

Good then, I defer to the wisdom of native speaker :)

—
Reply to this email directly or view it on GitHub
https://github.com/Mindwerks/worldengine/pull/202/files#r45135075.

@ftomassetti ftomassetti Nov 17, 2015

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.

It is agreed that the original sentence was not... great :D

@tcld tcld Nov 18, 2015

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Should I use "The created world..." or "A stored world..." instead? I think I will go with the former one for now.


For a generated world is also possible to generate additional maps, for example ancient looking map:
It is also possible to generate additional maps, for example an ancient looking map:

@ftomassetti ftomassetti Nov 17, 2015

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.

ok


```bash
worldengine ancient_map -w seed1.world
Expand All @@ -26,7 +26,7 @@ worldengine ancient_map -w seed1.world
![](https://raw.githubusercontent.com/Mindwerks/worldengine-data/master/images/examples/ancient_map_seed1.png)


We started a [google group](https://groups.google.com/forum/?hl=en#!forum/worldengine): if you have ideas, problems, suggestions or want to contribute please [join us](https://groups.google.com/forum/?hl=en#!forum/worldengine)!
We started a [Google group](https://groups.google.com/forum/?hl=en#!forum/worldengine): Should you have ideas, problems, suggestions or want to contribute, please [join us](https://groups.google.com/forum/?hl=en#!forum/worldengine)!

@ftomassetti ftomassetti Nov 17, 2015

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.

capital letter after colon?

@tcld tcld Nov 18, 2015

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I like it that way, although the topic seems to be a bit fuzzy.
http://www.apastyle.org/learn/faqs/colon-use.aspx

If the clause following the colon is a complete sentence, it begins with a capital letter.

or

The NYPL Writer's Guide urges consistency within a document; the Chicago Manual of Style says you may begin an
independent clause with a lowercase letter unless it's one of those two things (a quotation or more than one sentence).

So...both ways are possible, it seems.

@ftomassetti ftomassetti Nov 18, 2015

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.

ok then, I also learnt something :)


Interoperability (Python, Java)
===============================
Expand Down