Comments (10)
Hi everyone, thank you for reaching out. For now we have opted for a changelog at the beginning of the modified docs to keep track of the versioning.
I will close the issue for now.
from documents.
Hi everyone, sorry if my previous post was confusing. Please be assured that we have understood your concern about pdf. I took the liberty to mark the issue as closed for now to help us triage a bit more the threads. I'll keep it open then so that people know this issue has been raised before and avoid confusion.
from documents.
I'm looking forward to having to compare the next version line by line to find the change instead of looking at a diff.
from documents.
I agree there would be real advantages to using a plain-text easily diff-able format, e.g. Markdown or LaTeX. I suppose my comment was just to say that might not outweigh the benefits of whatever system the authors have used so far to create the PDFs, especially if that's something they are familiar and efficient with.
from documents.
from documents.
I think it's probably fine - these are documents for humans to read, not computer software - essentially academic papers like you might find on a preprint repository. You can't just change a line, run the tests and assume it's good.
As long as the people working on the DP-3T team can update the documents easily that may be enough. Anyone independent who wants to publish something based on these documents but different probably should follow academic norms, and write their own documents using appropriate referencing when they take ideas from these ones.
from documents.
@gagarine - ah! silly me ... not used to seeing PDFs in repos ..;) - thanks.
from documents.
Maybe in addition to markdown or LaTex format, I could recommend asciidoc. Similar to markdown, It renders nicely in github and also can produce nice looking printable (.pdf) documents.
from documents.
Not only are the docs in PDF, they are in image based PDF.
This is indeed not very well suited for collaborative work on text documents (can't copy/quote/fork)
and should be easy to change, as authors have a text version at hand, before saving as PDF.
from documents.
@sebastianbuettrich it's because you see the PDF preview from Github. If you download it it's fine.
@bdsl As a side note, those PDF were probably created from Google Drive (produced by Skia/PDF m83).
from documents.
Related Issues (20)
- Was DP-3T Exposure Calculation.pdf Android only? HOT 1
- Stability of distance estimation in case of using a bluetooth Extender HOT 2
- [Public Engagement] Visual Explainer / Scrollytelling on Privacy Preserving Proximity Tracing
- Mistake in communicating how information is passed around, in CH implementations of the apps HOT 3
- Reproducibility of Figure 1 in "DP3T - Exposure Score Calculation.pdf" HOT 3
- Risk calculation when exposed to multiple infectors both for < 15 min. HOT 7
- Naive secret sharing would allow for "jamming" on a non-physical level
- Why did the SwissCovid team not disclose the existence of the LASEC report? HOT 15
- Add support for multiple epidemics HOT 1
- [DOCUMENTATION] FAQ on Apple/Google framework issues HOT 1
- App feature request: Show stored app data as visualization of contact events HOT 3
- Schedule for F-Droid (and/or direct download) release of the Android app HOT 3
- [DOCUMENTATION] Cartoon, Dutch version, one pager: wrong text in picture 6. HOT 1
- Smartwatch App - Market Analysis (WearOS, WatchOS, Fitbit OS and Garmin Watch OS) and way forward HOT 1
- Who controls the 0xFD68 Bluetooth UUID?
- Potential privacy issue of new Exposure Notifications Express? HOT 3
- Wrong text on panel 6 of the NL onepage graphic HOT 1
- Update French onepage translation HOT 2
- Would like to understand the time window for notification
- Question: Where can I find the BLE MAC randomization code in DP^3T?
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 documents.