Comments (3)
We can remove some of the punctuation signs by using dashes in place of commas, so we at least don't require to concatenate them to the preceding word
The problem is that we'd be replacing the commas with the minus sign -
and not a real em-dash —
, which would be a punctuation error. And I'm not sure how Polygen handles em-dashes in source files, due to the char (151) being outside the ASCII range, which makes it problematic if the source file is being encoded as UTF-8 (for it would be represented by a two code points sequence). If we stick to plain ASCII characters we avoid presenting the reader with examples that could lead to encoding problems (specially with beginners).
Unfortunately, in many modern editors and IDEs it's quite hard to work with ASCII/ISO-8859-1 encoding, for they easily break it and switch to UTF-8 if you paste some contents from an UTF-8 document (instead of converting the clipboard to ISO-8859-1). So, I suggest keeping the commas to avoid similar issues.
from polygen-docs.
In the following sentence, the order of words can be altered for a more natural flow:
To avoid writing each and every variation of a sequence in which some atoms swap positions, you can enclose within curly brackets
{
and}
the subproductions that need to be permutated.To avoid writing each and every variation of a sequence in which some atoms swap positions, you can enclose the subproductions that need to be permutated within curly brackets
{
and}
.
Although the latter flows slightly better it introduces some semantic ambiguity, which causes some degree of strain on the reader to resolve it.
from polygen-docs.
The commas problem in §2.7, mentioned by @RBastianini, also affects the Italian document; so I've created an issue for it: #37
from polygen-docs.
Related Issues (20)
- Highlight Assets no Longer Required HOT 2
- Create Release v1.1.0 HOT 1
- Switch Downloader to Bash Script and Use Tar HOT 1
- PML EN: Typos in §2.3
- PML EN: Typo in §1 HOT 1
- Misc suggestions for section §2.4 (and nested paragraphs) HOT 3
- Preparing Release 1.1.1
- Misc suggestions for section 2.5 and 2.6
- Implicit / missing details about label selection HOT 5
- Document Repo and Docs Versioning Scheme
- Release 1.1.1 Checklist
- Examples with Labels before They Are Introduced HOT 1
- Fix PP Macros to Work with Latest PP HOT 1
- Add CHANGELOGs
- Revising and Improving PML Docs Contents
- Fix Examples in §2.7 Permutazioni
- PML Spec IT: Fix Title Style in §4.2.2.1
- Suggestions for sections 2.11 up to section 3 HOT 2
- Duplicated paragraph in section 3 HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from polygen-docs.