Comments (4)
Che ne pensi @alvisespano?
Sebbene si tratta solo di un dettaglio, mi rendo conto che ogni volta che rileggo quella sezione ci metto qualche minuto ad accorgermi della presenza di parentesi tonde nel secondo sorgente, e trarre un senso dal secondo esempio.
Questo avviene nonostante abbia letto e riletto il documento più e più volte, in entrambe le lingue, quindi immagino che per chi legge il documento la prima volta debba essere ancor più difficile cogliere la differenza tra i due esempi — soprattutto perché le parentesi grafe sono molto simili a quelle tonde nei font monospace, a quelle dimensioni di carattere.
Aggiungere una frase di avvertimento che indichi al lettore l'uso di parentesi differenti nei due esempi ci costerebbe poco e nulla, ma potrebbe fare una grande differenza per il lettore.
from polygen-docs.
Sono d'accordo con te: non è così chiaro. Cambiare esempio non è semplice: è praticamente un minimal example. Come dici tu, conviene spiegare meglio nel testo: sottolineare che sono graffe quelle parentesi; e nel secondo esempio rimarcare che sono tonde quelle più a destra.
from polygen-docs.
Ottimo, allora provvedo subito. Magari uso uno degli appositi blocchi per le note, che sono carini da vedere e, al contempo, sono un "contenuto laterale" al testo.
from polygen-docs.
OK, fatto!
Spero che il testo della nota vada bene.
Nell'inglese:
BEWARE! — The two examples below might look the same at first glance, but their endings are different:
- the first example uses braces:
{"I" {will depart} {alone}} ;
- the other one uses parentheses:
("I" {will depart} {alone}) ;
Nell'italiano:
ATTENZIONE! — I due esempi che seguono posso sembrare identici di primo acchito, ma differiscono nella parte finale:
- il primo impiega parentesi graffe:
{{io} {partiro'} solo} ;
- il secondo parentesi tonde:
({io} {partiro'} solo) ;
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
- Misc suggestions for section 2.7 - 2.10 HOT 3
- 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.