#opendaylight-docs: docs

Meeting started by colindixon at 16:04:17 UTC (full logs).

Meeting summary

  1. agenda bashing (colindixon, 16:04:24)
    1. docs patch reviews (colindixon, 16:04:32)
    2. denise has a list of questions she wants to bring up (colindixon, 16:05:01)

  2. docs patches (colindixon, 16:07:21)
    1. https://git.opendaylight.org/gerrit/#/q/project:docs+status:open+NOT+label:Code-Review%253C0 we have lots of patches that need review (colindixon, 16:08:00)

  3. denise's questions (colindixon, 16:08:15)
    1. https://docs.google.com/document/d/1IA31oRAEO155fygbENCYb6QKKTg7G5lxtSlBOusXvNc/edit the new, higher-level getting started guide which Denise has been interating on (colindixon, 16:09:01)
    2. colindixon and Denise went over the first half (through near the end of the concepts and tools)) and made minor eits (colindixon, 16:11:10)
    3. denise and colindixon ask about the use of the world component vs. projects vs. features in the document (colindixon, 16:15:03)
    4. phrobb says his goal was to refer to features, colindixon says that was also his goal, but he and Denise thought that avoding talking about projects at all likely does users a disservice as they need to know what project a feature belongs to get help, file bugs and the like (colindixon, 16:20:37)
    5. ACTION: zxiiro to talk to yangtools about removing maven 3.1 support to get this merged and then find a second project that we could play with, likely mdsal (colindixon, 16:22:22)
    6. ACTION: colindixon to add being able to auto-generate YANG RE this as a requirment for Boron (colindixon, 16:22:23)
    7. ACTION: colindixon to try to work on getting project categorization for this page https://wiki.opendaylight.org/view/Project_list (colindixon, 16:22:24)
    8. ACTION: https://wiki.opendaylight.org/view/Docucentral colindixon to work with casey to start to populate this (colindixon, 16:22:25)
    9. ACTION: denise will change component to either project or feature as appropriate (colindixon, 16:22:55)
    10. denise asks about the Karaf web console, colindixon says he's never heard of anyone using it with OpenDaylight, and unless we can find somebody to show it working with ODL, we should drop it (colindixon, 16:24:06)
    11. denise asks about NeXT UI toolkit in OpenDaylight and if they exist and that they plan to ship with Beryllium and that it will be an alternate UI (colindixon, 16:25:48)
    12. ACTION: anipbu to set up a meeting with denise, phrobb, CaseyODL, to get a demo from NEXT to figure out what's there and how to document it (colindixon, 16:26:26)
    13. denise asks about the big feature table (colindixon, 16:31:14)
    14. colindixon says that the columns now are "human readable name for the feature", "description of the feature", "OpenDaylight feature name", "compatibility information" (colindixon, 16:31:51)
    15. colindixon and phrobb say in their mind this big table should talk about only features, but maybe point out afterward that if you want help, you might want need to identify the project providing the feature, there should be another section some where that helps connect those dots (colindixon, 16:38:50)
    16. anipbu asks if we could shorten this table, colindixon says he doesn't see how to do it because we won't agree on what are the "common" or "important" feautres (colindixon, 16:39:18)
    17. ACTION: colindixon and phrobb to help denis in updating this table, there's an e-mail about this (colindixon, 16:40:49)
    18. ACTION: anipbu to work with colindixon and phrobb to see if some projects wanted to voluntarily list (some of) their features as experimental (colindixon, 16:42:46)
    19. colindixon asks if the compatibility column was clear, denise said it was to her and she liked it (colindixon, 16:53:16)
    20. colindixon notes that there are places where we will explicitly ask people to install multiple self+all features, e.g., SFC+GBP, and that's OK (colindixon, 16:54:20)
    21. colindixon says we should document feature uninstallation, which basically amounts to reinstalling ODL and starting from scratch, but we still need to document it (colindixon, 16:54:56)
    22. when it comes to APIs and features, some projects do really well about documenting what they're about and their APIs, but others either have nothing or are inscrutable (colindixon, 16:55:43)
    23. Denise asks what to do for the projects with nothing or bad summaries (colindixon, 16:56:42)
    24. colindixon says everyone should at least have an overview paragraph in the user guide, maybe we could use that (colindixon, 16:57:03)
    25. https://www.opendaylight.org/whats-new-lithium Denise and CaseyODL think this is also a really good place (colindixon, 16:57:54)
    26. colindixon notes that not all projects are there, e.g., yangtools is missing, also it needs updating for Beryllium, e.g., the controller doesn't actually act as controller now (colindixon, 17:00:51)
    27. phrobb says that this is the wording from his slide deck, but talk to Melissa about it (colindixon, 17:02:19)


Meeting ended at 17:03:11 UTC (full logs).

Action items

  1. zxiiro to talk to yangtools about removing maven 3.1 support to get this merged and then find a second project that we could play with, likely mdsal
  2. colindixon to add being able to auto-generate YANG RE this as a requirment for Boron
  3. colindixon to try to work on getting project categorization for this page https://wiki.opendaylight.org/view/Project_list
  4. https://wiki.opendaylight.org/view/Docucentral colindixon to work with casey to start to populate this
  5. denise will change component to either project or feature as appropriate
  6. anipbu to set up a meeting with denise, phrobb, CaseyODL, to get a demo from NEXT to figure out what's there and how to document it
  7. colindixon and phrobb to help denis in updating this table, there's an e-mail about this
  8. anipbu to work with colindixon and phrobb to see if some projects wanted to voluntarily list (some of) their features as experimental


Action items, by person

  1. anipbu
    1. anipbu to set up a meeting with denise, phrobb, CaseyODL, to get a demo from NEXT to figure out what's there and how to document it
    2. anipbu to work with colindixon and phrobb to see if some projects wanted to voluntarily list (some of) their features as experimental
  2. colindixon
    1. colindixon to add being able to auto-generate YANG RE this as a requirment for Boron
    2. colindixon to try to work on getting project categorization for this page https://wiki.opendaylight.org/view/Project_list
    3. https://wiki.opendaylight.org/view/Docucentral colindixon to work with casey to start to populate this
    4. colindixon and phrobb to help denis in updating this table, there's an e-mail about this
    5. anipbu to work with colindixon and phrobb to see if some projects wanted to voluntarily list (some of) their features as experimental
  3. UNASSIGNED
    1. zxiiro to talk to yangtools about removing maven 3.1 support to get this merged and then find a second project that we could play with, likely mdsal
    2. denise will change component to either project or feature as appropriate


People present (lines said)

  1. colindixon (36)
  2. odl_meetbot (3)
  3. anipbu (1)


Generated by MeetBot 0.1.4.