[jira] [Work logged] (BEAM-6557) Add IPython notebooks for quickstarts and custom I/O

["ASF GitHub Bot (JIRA)" <ji...@apache.org>]

     [ 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:
users@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)