Comments (5)
Representing large numbers like 4,000,000 as 4*1000*1000
instead of 4000000
makes them easier to read, debug, and maintain.
I'd keep the clockspeed as it is, but I agree more readable property names for polarity and phase would be an improvement.
from t2-docs.
If we were using Java/Python/Rust, representing it as 4_000_000 would be ideal. ;) Since this is for docs, it probably if we show the audience clock speed can just be represented as 4000000
. (Persons writing their own codebases can use the expanded *1000
forms. Different audience.)
+1 to polarity and phase. Where did terms CPHA and CPOL even come from? We probably sourced them from Arduino examples way back in the day, but I haven't really seen them used outside of that domain. (Also see "mode" etc.)
I feel like "clockSpeed" is more applicable than "frequency" but YMMV.
from t2-docs.
Hi guys, I'm new here, and am a pretty green programmer. Would it make sense to create a constant titled MHz (or some other descriptive name) instead, and set it equal to 1000x1000? That way the expression could become "4*MHz" which could be even more readable.
from t2-docs.
Hi @Frijol ! Can the issue be closed now that the pull request has been merged? Or is there something else that needs to be done?
from t2-docs.
Yes, thanks for noticing!
from t2-docs.
Related Issues (20)
- i2c.send and i2c.read are not documented
- GPIO function diagram HOT 2
- i2c send method example HOT 1
- Tessel.io/opensource info port HOT 2
- "How do I know if I need to update" section should mention auto-notifications HOT 7
- github.com/tessel/docs should redirect to here
- Image links are broken on hardware>T2 overview HOT 3
- `t2 restore` is undocumented HOT 6
- Include physical dimensions in hardware overview HOT 2
- Link for GPIO pins directing to a page that cannot be found HOT 1
- Add ability to execute code on time interval HOT 1
- Link for Technical overview leading to a page that cannot be found HOT 2
- Extended instructions for using `t2 root` on Windows?
- Pinout diagram not rendering in t2 docs HOT 2
- Make pin diagram a link to a larger version of the image
- Improve 5V sourcing section HOT 6
- Document `pin.toggle()` HOT 2
- I2C Tutorial HOT 8
- Pinpull Tutorial link broken HOT 4
- Migrate to new version of Gitbook? HOT 2
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 t2-docs.