Comments (7)
The g3doc used in Tensorflow is, I believe, identical to Markdown. If you find anything that doesn't meet the markdown specification, file an issue.
from tensorflow.
I mean the comments in the C++ that are used to generate the markdown files.
Example:
https://github.com/tensorflow/tensorflow/blob/master/tensorflow/core/public/env.h#L47
/// \brief Returns a default environment suitable for the current operating
/// system.
///
/// Sophisticated users may wish to provide their own Env
/// implementation instead of relying on this default environment.
///
/// The result of Default() belongs to this library and must never be deleted.
static Env* Default();
is used to generate
* [`static Env* tensorflow::Env::Default()`](#static_Env_tensorflow_Env_Default)
* Returns a default environment suitable for the current operating system.
and
#### `static Env* tensorflow::Env::Default()` {#static_Env_tensorflow_Env_Default}
Returns a default environment suitable for the current operating system.
Sophisticated users may wish to provide their own Env implementation instead of relying on this default environment.
The result of Default() belongs to this library and must never be deleted.
My point is that the docs were pre-generated. I can't find another project where Google has open sourced the g3doc utility so that others may rerun it and update the documentation.
If the answer is "the syntax is just like doxygen", then that's an acceptable answer, although it would still be nice to be given the same tool to generate the markdown.
from tensorflow.
The syntax is, in fact, doxygen: part of our docs generation pipeline calls doxygen. We are working on making more of the doc generator publicly available, but it requires a decent amount of untangling.
from tensorflow.
Is there a blog post or guide out for this yet?
from tensorflow.
Check out the documentation authoring guide: https://www.tensorflow.org/community/documentation
from tensorflow.
Is the engine now open source though? (If I didn't want to build it specifically as a part of tensorflow docs, rather use it for my own markdown rendering )?
This video (dated 2016) is really fascinating in concept. It would be great if the whole system were fully elaborated upon.
from tensorflow.
Everything from TensorFlow source code to markdown is open-source. It should be usable for other projects, although the code may have aspects specific to TensorFlow which may not trivial to extract.
TensorFlow docs are not served using g3docs. I cannot speak to the specifics of that presentation.
from tensorflow.
Related Issues (20)
- ValueError occurred when building cascaded model with loaded sub-model HOT 6
- Conv2D computes wrongly in Windows OS HOT 2
- Saving a model defined by model subclassing can not be saved HOT 3
- I am encountering an error: Error with computation = RQAComputation.create(settings, verbose=True) when I use HPC. However, I do not encounter any error when I use my personal laptop for the same code and installing the same package : from pyrqa.computation import RQAComputation HOT 1
- TF 2.16 Incorrect model with TextVectorization in SavedModel format contains float input type instead of string type
- MultiWorkerMirrorStrategy Metrics Incorrectly Aggregating HOT 2
- WARNING:tensorflow:Your input ran out of data; interrupting training always occuring after 80% of total epochs HOT 1
- Input shape changed after converting model to tflite HOT 2
- protobuf fatal error in Tensorflow 2.16.1 on macos M1 HOT 4
- Cannot create TFLite model with TF 2.16 HOT 2
- no matching function for call to 'MakeOneDnnStream' HOT 3
- Problem with Tensorflow 2.16.1 and gpu HOT 2
- tensorflow=2.16 cant use GPU HOT 3
- `tf.cast` does not preserve requested precision for Python types of float64/int64/complex128 etc
- ImportError when using tensorflow 2.8.0 and python 3.9.16 undefined symbol: PyCMethod_New HOT 2
- Error with loading a .pb model for prediction: Op type not registered 'DecodeProtoSparseV4' HOT 3
- Tensorflow import and GPU env HOT 2
- could not find valid device for node when call tf.acos
- Calling submodels in train_step throws ValueError when saving and loading error.
- Change camera lens
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 tensorflow.