--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CACuR13eexUCnzrTbG_icvm%3DXc9cuCyxWXziOftsqj1kcpeC6xA%40mail.gmail.com.
I would like to know what kind of documentation that is missing. Is it high level Chromium architecture, or class/algorithmic comments? I know both are missing, but what do those that clicked "need better documentation" think about when they clicked it?One thing everyone seems to agree on is that the old idea that inline comments are meaningless because code should be self explanatory is not a good idea.Code should be self explanatory, in the way that you should always see what the code is doing, but comments are needed to explain why something is a good idea and what the code intends to do. Especially in the web platform code, knowing that something is done tells you little about why it should be done.
Personally I do miss high level architecture docs. Just the other day I was trying to find anything written about components and services and failed badly. Wherever that is documented, it is not easy to find. And the outcome of the platform discussion, will it be put in print anywhere "official"?
/Daniel
--Hello again, results are in. The short version is, we have some work to do, especially around documentation and code structure.Presentation summary (BlinkOn slides): https://docs.google.com/presentation/d/1LIR5gA9Sg-bejvRaB5F1EqNq6mLf5hMYcNiHGQyj6ag/edit?usp=sharingThis talk should have been recorded, and so a video will eventually be released.Automatic response summary: https://docs.google.com/forms/d/16o41lqUNS2Fzy3Km5Pm8j-DVM41_AdXgYNE0E9yM8ig/viewanalyticsRaw responses spreadsheet: https://docs.google.com/spreadsheets/d/1BqCAu7dPUyK5ZYePBD0efVUfyk7aE4DL9uSZYLbAdQY/edit?usp=sharingWe intend to also fan out some team-specific comments to the relevant team mailing lists.On Tue, Mar 20, 2018 at 7:32 AM, Jeremy Roman <jbr...@chromium.org> wrote:Hey there, Blink-folk!The results of an internal survey suggest that many of us feel hindered by technical debt and overly complicated code.We want to know what slows you down while developing web platform code in Chromium.Befuddled by garbage collection? Tell us!Sick and tired of writing yet another wrapper class? Let us know!Please fill out this survey:We'll share the results after the survey closes.
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CACuR13eexUCnzrTbG_icvm%3DXc9cuCyxWXziOftsqj1kcpeC6xA%40mail.gmail.com.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/platform-architecture-dev/CACuR13cZsDUaEaozAKN%3DbiVeunfW3CQ_iqGK1O1Nq-dksFAP7g%40mail.gmail.com.--
You received this message because you are subscribed to the Google Groups "platform-architecture-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to platform-architecture-dev+unsub...@chromium.org.
To post to this group, send email to platform-architecture-dev@chromium.org.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CACuR13eexUCnzrTbG_icvm%3DXc9cuCyxWXziOftsqj1kcpeC6xA%40mail.gmail.com.
--/* Opera Software, Linköping, Sweden: CEST (UTC+2) */
--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/op.zhzgpfwarbppqq%40cicero2.linkoping.osa.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CACuR13eexUCnzrTbG_icvm%3DXc9cuCyxWXziOftsqj1kcpeC6xA%40mail.gmail.com.
--/* Opera Software, Linköping, Sweden: CEST (UTC+2) */
--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/op.zhzgpfwarbppqq%40cicero2.linkoping.osa.
--
You received this message because you are subscribed to the Google Groups "platform-architecture-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to platform-architecture-dev+unsub...@chromium.org.
To post to this group, send email to platform-architecture-dev@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/platform-architecture-dev/CAAozHL%3DhdHKOsp3Cof8EFxfRQiMq9UkbANXQso6DQFWWPy81eQ%40mail.gmail.com.