[
https://issues.apache.org/jira/browse/BEAM-6557?focusedWorklogId=224476&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-224476
]
ASF GitHub Bot logged work on BEAM-6557:
----------------------------------------
Author: ASF GitHub Bot
Created on: 08/Apr/19 17:05
Start Date: 08/Apr/19 17:05
Worklog Time Spent: 10m
Work Description: melap commented on issue #7679: [BEAM-6557] Adds
notebooks for quickstarts and custom I/O
URL: https://github.com/apache/beam/pull/7679#issuecomment-480917307
Forgot to comment on the question from Ahmet when I did the review. This is
a tough one, because:
Using markdown: I agree it is easiest to contribute/audit. If we want
everything in markdown and still have a walkthrough-like notebook experience,
we have to maintain two versions of the text (markdown and in the notebook) and
keep them in sync, either by having the contributor update both places for
every change, or someone else has track changes and open a followup PR. And
that's just for 1 language -- if we have similar labs for Java and Go, we're up
to 6 versions of similar text (3 in markdown, 3 in a lab). Tensorflow avoids
the language multiplier because they only have Python.
Using generated web pages from Colabs: Definitely would be more difficult to
contribute, having to edit Colabs. But generating the pages would mean only 3
versions of similar text (1 per language). also, it's my understanding that
Colabs are not accessible in some locations, so generating web pages from
Colabs would allow those users to access all of the material, it just wouldn't
be interactive.
I agree we should generate the py and test the snippets if possible.
whichever way we go, this will likely affect contributor experience
(particularly if you have to modify notebooks), so this might be a good
discussion for the mailing list, to see what the community thinks.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
Issue Time Tracking
-------------------
Worklog Id: (was: 224476)
Time Spent: 3h 10m (was: 3h)
> Add IPython notebooks for quickstarts and custom I/O
> ----------------------------------------------------
>
> Key: BEAM-6557
> URL: https://issues.apache.org/jira/browse/BEAM-6557
> Project: Beam
> Issue Type: Improvement
> Components: website
> Reporter: David Cavazos
> Assignee: David Cavazos
> Priority: Minor
> Labels: triaged
> Time Spent: 3h 10m
> Remaining Estimate: 0h
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
