Developing Docs for OpenDaylight

•Download as PPTX, PDF•

2 likes•2,262 views

The presentation discusses OpenDaylight's efforts to improve open-source content development. It outlines moving from an initial wiki-based documentation system to a more professional setup using AsciiDoc, Maven tooling, and a Git repository based on lessons from OpenStack. Challenges include catching up documentation to the codebase and coordinating documentation as a team effort across the open-source community with limited resources. The goal is to establish consistent, consolidated documentation with better searchability.

Technology Education

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public

Open-Source Content Development
in OpenDaylight
Paul Zimmerman
Manager, NOSTG Developer Content

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Agenda
• The Story So Far
• Moving Forward
• Challenges

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
What is OpenDaylight?

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
In The Beginning…

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
More Projects…

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Hydrogen Release

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
“Professional” Doc Set
• Three main types:
– Structured product documentation (installation, user guides)
– Auto-generated documentation (API references)
– Project documentation (specs, plans)
• Consistency
• Consolidated topics
• Better Search
• Higher expectations

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Example: OpenStack
• Similar doc types
• Robust instructions
• Tooling
• Lessons learned

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Tooling Structure
Topic
Topic
Topic
Topic
Topic
Maven
BitBucket Repository
OpenDaylight Site
Develop
Review
Revise

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Authoring
• AsciiDoc mark-up language
• Easy markup for developers
• Easy to adapt from MediaWiki
• Checked in and out like code

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Voila!

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Next Steps
• Finalize tooling
• Create similar look & feel for autogenerated content
• Clean up wiki
• Develop community

• “Your Life as a Developer” Survey 2013
JFrog Artifactory
“65% of developers from over 150 Fortune 500
companies cited documentation as one of the
biggest challenges of open-source software”

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Documentation Struggles
Open Source
• Focus on software
• Team effort on docs
OpenDaylight
• Planning for future distributions
• Catch-up
• Resources

© 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public
Questions?
For additional Q&A,
please meet me in the
DevNet API Expert Zone

This session will include an overview of Cisco Finesse including architecture, business value, and feature set for both the Contact Center Express and Enterprise product lines. After this, we will go deeper including how utilize the Finesse API for custom development and other topics important to the developer. In addition, we will go through what it takes to successfully deploy Cisco Finesse. This presentation was made in the DevNet Zone at Cisco Live, San Francisco, 2014.

API SDK Development – Lessons Learned

Pronovix

Building a solid API is a challenge but getting our APIs to be adopted by a larger audience, we quickly realized that having solid SDKs is the key element. At Rubrik we have been developing SDKs to supplement our APIs for over 3 years and during this process we have been making sure our SDKs provide a seamless experience for end-users to consume. When breaking API changes occur during the development of our product. The key takeaways of this session are: * How to strategize SDK development against an ever-changing API * Securely open-source your SDK development process

Secure by design: Scaling security across the enterprise

MuleSoft

By 2020, Gartner predicts 60% of digital businesses will suffer major service failures due to the inability of the IT security team to manage digital risk in new technology and use cases. As security failures quickly become headline news, CIOs and CISOs are under tremendous pressure to keep the business secure -- without slowing the business down. That's why incorporating security by design into applications and services is so crucial for the enterprise. In this session, we will discuss how applications networks are helping organizations federate security best practices, leverage machine learning to more proactively respond to threats and deliver defense in depth.

Cloud summit 2019 - Scania

Mattias Järnhäll

Object Store

MuleSoft

when Apps meet Infrastructure - CodeMotionMilan2018 Keynote - Cisco DevNet - ...

Cisco DevNet

Are there days when you wake up and tell yourself: "it's too bad, I wish I was born a decade or two earlier, there was so much to create then"? Well, at DevNet, we think you are lucky and in the exactly right decade! I joined DevNet - Cisco's Developer Program - a couple of years ago, looking forward to explore how applications could better leverage the pieces of infrastructure laying here and there. I'll share some use cases I discovered while building prototypes and supporting hackathons, in the hope of inspiring you for your next startup or simply learn and have fun on the way.

apidays LIVE India - The link between technical documentation and developer e...

apidays

Presented by: Tom Wilson, hyper63 Presented at the All Things Open Virtual Meetup Abstract: APIs (Application Program Interfaces) is how programs can talk with other programs and is a design consideration for many products. Let’s discuss: Why you should build an application with an API? What are the top 5 requirements of designing an API with examples? Some open-source javascript frameworks that can help you design and build your API. In order to get the most out of this talk, you should have a good understanding of http REST protocol and general application development. Familiarity with javascript and technologies like NodeJS and Express would be a plus. In this talk, you should come away with a good understanding of why you should consider building an API in your application, key good practices every API should include, and how you could implement an API using Javascript.

[WSO2 Integration Summit London 2019] An API-enabled Journey Towards Empoweri...

WSO2

Integration plays an essential role at Elsevier, a global information analytics company and one of the world's major providers of scientific, technical, and medical information. Founded in 1880, Elsevier has a bold tradition of innovation and has embraced APIs to increase availability, security and adoption of information. John Underhill, an integration architect at Elsevier, will share the success story of moving to the right API maturity model by adopting microservices and automated DevOps using WSO2 API Manager. John will discuss how they implemented a successful API program, the challenges they faced, and some of the lessons learnt. Watch the session: https://wso2.com/integration-summit/london-2019/

Alpha Five v11 and IIS supportRichard Rabins

Choosing the right business model and license - OW2con'19, June 12-13, 2019, ...

OW2

Gilles Gravier, Director, Senior Advisor in Open source and blockchain at Wipro Technologies, presented at OW2con'19 "Choosing the right business model and license to support it for your open source project to survive". Abstract: An open source project is really no different from any other when it comes to business models. There are no "open source business models" but there are business models that work better for open source projects, and selecting the right kind of license is one of the key elements to supporting the business model you have in mind for your project. We will examine types of business models and open source licenses and how to chose them based on the product you are developing.

Voices of Product: Discovery and Framing

Roxanne Mustafa

Scania's DevSecOps approach - Gamifying Security - auto:CODE

Anders Lundsgård

Idea to production

Roi Ezra

Offline Storage: Build secure, offline-first apps

RachelAshton5

Design-first API Development using Swagger and Node

Apigee | Google Cloud

Lessons Learned from Revamping Our Doc Site

Pronovix

New Enterprisre Capabilities in Telerik Platform

Lohith Goudagere Nagaraj

Leaping Forward: Finding The Future of Your API Docs

Pronovix

MuleSoft Meetup Winnipeg: Maiden Edition

MannaAkpan

apidays LIVE Paris 2021 - Privacy Engineering by Ian Oliver, Nokia Bell Labs

apidays

PayPal's History of Microservices Architecture

Postman

PayPal has evolved from using a monolithic architecture to a microservices-oriented architecture in order to scale the rapidly growing company. In this talk, We will take a look at how PayPal was architected in the past, some of the issues that we ran into with a monolithic architecture, and how PayPal evolved over time to create a more robust and scalable approach to service deployment by leveraging Postman and implementing a microservices architecture.

MuleSoft Meetup Singapore - Reliable Messaging & RTF Operations

Julian Douch

No. #10 edition of the Singapore MuleSoft Meetup. Our first speaker was Alyanna Lazaro, Technical Lead & Architect at Capgemini in Singapore, who provided practical insight on Reliable Messaging in Mule 4 demonstrating use-cases to best leverage AMQ . Our second speaker was Yohanes Sono, Technical Architect at MuleSoft in Singapore. He continued the RTF story, building upon last meet-ups introduction, with a deep dive into architecting and operationally managing an RTF deployment architecture.

Controller and Coffee: Deliver APIs in Real Time with API Management

NGINX, Inc.

Watch the webinar https://www.nginx.com/resources/webinars/nginx-controller-coffee-july-2020/ About the Webinar In this third installment of our webinar series, we focus on how NGINX Controller provides full API lifecycle management to deliver real‑time APIs. We also discuss how our secure platform helps accelerate application delivery with cloud automation and high availability. We answer questions like these: – How can NGINX Controller’s API Management Module help API owners publish, secure, and manage their APIs? – Why is NGINX Controller’s Developer Portal valuable for API management? – What types of API insights are available with Controller? – What are the benefits of cloud automation? – What are the benefits of high availability, and when do you need it? – How can you avoid common mistakes with API management and cloud automation? – How secure is the NGINX Controller platform? If you’re responsible for managing APIs and API management tools, or involved in a digital transformation initiative to speed time to market and performance of your apps, don’t miss this webinar!

Java 8 - Gateway Drug or End of Line?

Garth Gilmour

Mobile SDKs

Alexander Hradecky

DEVNET-1117 Open Source DevCenter Launched within DevNet

Cisco DevNet

Creating a Collaborative Enterprise

Cisco Canada

Great changes are occurring throughout organizations worldwide. New and rapidly evolving web 2.0 networking technologies promise the next generation advances in information technology and business capabilities. An increase array of multimedia communications technologies such as virtual workspaces, social networking tools, web conferencing applications, text messaging, internet phone services, and as if you are there video meetings are creating new possibilities for organizations to more quickly and effectively connect people.

What's hot

The Cloud Journey in an Enterprise - CoDe-Conf - Copenhagen October 11, 2018

Anders Lundsgård

A Starters Guide to Building APIs with Javascript

All Things Open

[WSO2 Integration Summit London 2019] An API-enabled Journey Towards Empoweri...

WSO2

Alpha Five v11 and IIS supportRichard Rabins

Choosing the right business model and license - OW2con'19, June 12-13, 2019, ...

OW2

Voices of Product: Discovery and Framing

Roxanne Mustafa

Scania's DevSecOps approach - Gamifying Security - auto:CODE

Anders Lundsgård

Idea to production

Roi Ezra

Offline Storage: Build secure, offline-first apps

RachelAshton5

Design-first API Development using Swagger and Node

Apigee | Google Cloud

Lessons Learned from Revamping Our Doc Site

Pronovix

New Enterprisre Capabilities in Telerik Platform

Lohith Goudagere Nagaraj

Leaping Forward: Finding The Future of Your API Docs

Pronovix

MuleSoft Meetup Winnipeg: Maiden Edition

MannaAkpan

apidays LIVE Paris 2021 - Privacy Engineering by Ian Oliver, Nokia Bell Labs

apidays

PayPal's History of Microservices Architecture

Postman

MuleSoft Meetup Singapore - Reliable Messaging & RTF Operations

Julian Douch

Controller and Coffee: Deliver APIs in Real Time with API Management

NGINX, Inc.

Java 8 - Gateway Drug or End of Line?

Garth Gilmour

Mobile SDKs

Alexander Hradecky

What's hot (20)

The Cloud Journey in an Enterprise - CoDe-Conf - Copenhagen October 11, 2018

A Starters Guide to Building APIs with Javascript

[WSO2 Integration Summit London 2019] An API-enabled Journey Towards Empoweri...

Alpha Five v11 and IIS support

Choosing the right business model and license - OW2con'19, June 12-13, 2019, ...

Voices of Product: Discovery and Framing

Scania's DevSecOps approach - Gamifying Security - auto:CODE

Idea to production

Offline Storage: Build secure, offline-first apps

Design-first API Development using Swagger and Node

Lessons Learned from Revamping Our Doc Site

New Enterprisre Capabilities in Telerik Platform

Leaping Forward: Finding The Future of Your API Docs

MuleSoft Meetup Winnipeg: Maiden Edition

apidays LIVE Paris 2021 - Privacy Engineering by Ian Oliver, Nokia Bell Labs

PayPal's History of Microservices Architecture

MuleSoft Meetup Singapore - Reliable Messaging & RTF Operations

Controller and Coffee: Deliver APIs in Real Time with API Management

Java 8 - Gateway Drug or End of Line?

Mobile SDKs

Viewers also liked

DEVNET-1117 Open Source DevCenter Launched within DevNet

Cisco DevNet

Creating a Collaborative Enterprise

Cisco Canada

Opendaylight beryllium

Cheolmin Lee

2015 2-23 Oxford Global 2015 Manchester

Alain van Gool

201131065aniinayah

Perfect 360Alfred Tan

2015 10-06 Building Bridges Biomarker symposium FIMM Helsinki, Alain van Gool

Alain van Gool

Vaizdine metodine medziaga svietejams 8 dalis sveiki ir laimingi vaikai

valentina valentina

Innovator's Guide to the IP Galaxy

Endcode_org

Website deconstructions

sophiebartram

CBIZ Women's Advantage Newsletter - Winter 2015

CBIZ & MHM Phoenix

Final Powerpoint

tlc6996

IoS-XR SW: partnering with Elastic: an overview

Cisco DevNet

A session in the DevNet Zone at Cisco Live, Berlin. Monitoring network equipment is hard, too many protocols each with their own tools for monitoring, MIBs always delivered as an afterthought, SNMP falls over at scale. We’ll introduce IOS-XR Telemetry, a push based fire hose of data, and our integration with ELK, a stack of open source tools for collecting all that data, indexing it, and turning it into graphs that are actionable.

Psyphotology Intern Presentationannarrowley

ΤΟ ΣΕΝΑΡΙΟ ΤΗΣ ΟΔΥΣΣΕΙΑΣ

Vacationns

Bijlage 2-shell-ffs-reactorpouya_ms

Presenting my edited photographsalexjr1996

Session 3 Attachment Aware Schools PresentationAndriaCampbell

3 ways fragmented clinical communication is compromising patient care

PatientSafe Solutions

Using Cisco pxGrid for Security Platform Integration: a deep dive

Cisco DevNet

A session in the DevNet Zone at Cisco Live, Berlin. This session will cover: Functional and architectural basics of Cisco Platform Exchange Grid (pxGrid), the new publish/subscribe/query contextual information exchange framework for creating integration between DevNet Zone partner platforms and Cisco security products; Integration use-cases such as utilizing pxGrid for executing threat response actions on the network and using identity, endpoint device and user access privilege context to enhance our DevNet Zone partners analytics, forensics and reporting; First-hand developer perspective from DevNet Zone partner ID/IP who used pxGrid to integrate Ping Identity and Cisco Identity Services Engine.

Viewers also liked (20)

DEVNET-1117 Open Source DevCenter Launched within DevNet

Creating a Collaborative Enterprise

Opendaylight beryllium

2015 2-23 Oxford Global 2015 Manchester

201131065

Perfect 360

2015 10-06 Building Bridges Biomarker symposium FIMM Helsinki, Alain van Gool

Vaizdine metodine medziaga svietejams 8 dalis sveiki ir laimingi vaikai

Innovator's Guide to the IP Galaxy

Website deconstructions

CBIZ Women's Advantage Newsletter - Winter 2015

Final Powerpoint

IoS-XR SW: partnering with Elastic: an overview

Psyphotology Intern Presentation

ΤΟ ΣΕΝΑΡΙΟ ΤΗΣ ΟΔΥΣΣΕΙΑΣ

Bijlage 2-shell-ffs-reactor

Presenting my edited photographs

Session 3 Attachment Aware Schools Presentation

3 ways fragmented clinical communication is compromising patient care

Using Cisco pxGrid for Security Platform Integration: a deep dive

Similar to Developing Docs for OpenDaylight

DEVNET-1149 Leveraging Rapid Development with PaaS on Cisco Cloud

Cisco DevNet

In this session, we will discuss common industry solutions for PaaS on private cloud, including Cloud Foundry and Openshift; and how to leverage such solutions on Cisco’s Cloud Platforms. We will then deep dive into sample application topologies on both platforms, demonstrating how to quickly create a continuous integration environment, utilising open source tooling, to enable DevOps-style practices and rapid 'prototype-to-production' environments. Finally, we will introduce Cisco’s roadmap for Intercloud in the context of PaaS and how this will enable future workloads to scale across multiple providers, locations and technologies.

Cisco Spark and Tropo and the Programmable Web

Cisco DevNet

Learn how Cisco Spark and Tropo collaboration features can be easily combined with hundreds of cloud APIs to build sophisticated, flexible workflows via a new breed of programmable web solutions from 'Integration Platform as a Service (iPaaS)' partners like Built.io, Zapier and IFTTT. This session covers multiple real-world Cisco+iPaaS use-cases, and includes a hands-on walk-through demonstrating how to build a Spark+Tropo sample application using Built.io. Watch the BRK-DEV2004 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92557&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Spring Tools 4 - Eclipse and Beyond

VMware Tanzu

SpringOne Platform 2017 Kris De Volder, Pivotal; Martin Lippert, Pivotal "In this session we will unveil a new generation of Spring tools. These new tools, which are mostly built from scratch, will not only include the next generation of the Spring Tool Suite (for Eclipse) called STS4, but will feature new and lightweight editor-centric alternatives, for editors such as Atom and Visual Studio Code. In each environment the new tools make it easier to develop Spring Boot applications, deploy applications to Cloud Foundry, develop CI pipelines for those apps, and more. In this session we will show all of these in action using live coding. The session will include writing, running, testing, and debugging Spring boot applications using Spring Tool Suite, Eclipse, Atom, and Visual Studio Code. We will live code a CI pipeline for them, deploy them to Cloud Foundry, and see how running applications feed information back into your coding environment to further help you understand, debug, and develop your Spring Boot applications. We will also look at the underlying technology that enables us to create tooling just once and make it available easily across a variety of editors and IDEs."

Keynote upload

Ken Owens

The Cisco Intranet Case Study by Todd West

Prescient Digital Media

Getting Started with OpenStack

Cisco DevNet

A session in the DevNet Zone at Cisco Live, Berlin. Hearing a lot about OpenStack and want to check it out for yourself? See how quick and easy it is to install and start using OpenStack within a VM on your own laptop. Acquaint yourself with the environment. Learn your way around Horizon (GUI) and the CLI to view and operate an OpenStack cloud, both from the perspective of a cloud administrator and as a tenant/user of the cloud. See how to automate typical workflows such as deploying a new multi-tier application. Best of all, take what you learn with you and experiment on your own to discover all OpenStack offers you.

Cisco Spark – Collaboration Tool to facilitate for e-Learning

eLearning Consortium 電子學習聯盟

Nonprofit Homepage Design Slam - 10 tips for Effective Homepage Design

Lacey Kruger

Your nonprofit's homepage is the first impression your constituents have of your organization. It lets site visitors know who you are and what drives your mission. So what kind of impression are you making? Join us April 29 at 11:00a C.T. for this month's Luminate Community webinar, where we'll cover The 10 Rules of Effective Homepage Design followed by live evaluations of homepages from volunteers in attendance. After attending, you'll know the hallmarks of a good homepage design and how to effectively critique your own. This session is a favorite at our bbcon conference, and we're excited to present it virtually. You won't want to miss it!

ScrumDay 2014 - Développer des produits avec des équipes distribuées - Alexis...

Alexis Monville

CI/CD pipeline security from start to finish with WhiteSource & CircleCI

WhiteSource

Open source software components play an important role by providing us with the building blocks of our products. However, even as we enjoy the benefits of open source components, they are not without their challenges, especially when it comes to security vulnerabilities. In this webinar with Circle CI, you'll learn how: - WhiteSource Orb can help teams catch vulnerabilities within open source components at early stages of the development cycle - You can start implementing the WhiteSource CircleCI orb into your CI configuration - To gain insights into your software helping you make smarter decisions in working with open source components.

IBM and OpenStack: Collaboration Beyond the Code

Daniel Krook

Presentation at the OpenStack Summit in Paris, France on November 5, 2014. As the largest open source project in the world, OpenStack is produced by a huge and diverse community of global contributors.  The most high profile efforts come from the individuals and organizations that produce the code and package the releases, however there are many other ways to get involved. In this sponsored session, we will highlight some of the key ways that IBM participates in the OpenStack community. We'll start off by reviewing some of our major code contributions, then we will highlight our conference and summit content, local meetup leadership activity, social media activism, web content, and more. After this presentation, you'll appreciate the full range of the activities that make an open source community strong, and learn how you can take part in the OpenStack community, as IBMers have. Finally, you'll have a chance to provide your feedback to guide IBM with its community activities, and have a starting point to get involved yourself. Daniel Krook - Senior Certified IT Specialist Manuel Silveyra - Senior Cloud Solutions Architect

Essentials of Open Source Documentation

Moi Borah

DEVNET-1125 Partner Case Study - “Project Hybrid Engineer”

Cisco DevNet

Programming and API knowledge are common themes across SDN and “Open”. As we focus more on software, we will see a proliferation of APIs and a need to understand programming. An effective _hybrid_ engineer tomorrow will have both solid networking skills as well as an understanding of programmatic concepts. Keeping these technology and industry transitions in mind, Cisco Americas Partners Organization (APO) kicked off “Project Hybrid Engineer” this summer for Cisco Partners SEs with a focus on enhancing hands-on network programmability knowledge. This session highlights some of the key initiatives underway where APO is taking its experiences and enabling key Cisco Partners workforce for Cisco's Network Programmability solutions early on in the lifecycle. If you are a Cisco Partner, come and learn how you can benefit from “Project Hybrid Engineer” and get your workforce ready for this key technology transition.

Mix-IT - Des Produits avec des Equipes Distribuées

Alexis Monville

De nos jours, presque tout le monde sait faire grandir une infrastructure de machines en mode distribué, avec une très bonne communication entre elles, et en évitant les points uniques de défaillance (c'est une traduction de SPOF, single point of failure). En y réfléchissant, des serveurs distribués à travers le monde ne sont pas si différents que des équipes distribuées, elles ont besoin de connection et de synchronisation... Vraiment ? Nous sommes des humains... pas des machines… Dans cette session, nous allons voir comment eNovance, une société qui conçoit des produits destinés à batir des infrastructures informatiques, d'ou le pitch initial... Nous allons donc voir comment eNovance a fait grandir son équipe de développement produits en mode distribué en suivant les valeurs et principes agile. Cette session expliquera comment nous nous appuyons sur nos Product Owner pour guider nos contributions à des logiciels libres constitutifs de nos produits. Nous verrons par exemple comment nous planifions nos itérations en suivant le rythme donné par le projet Openstack. Nous verrons également comment nous organisons nos scrums, sprint planning, sprint review et retrospectives en nous adaptant à des équipiers positionnés sur différents fuseaux horaires. La session présentera le mode de fonctionnement d'un projet open source emblématique : Openstack. Ainsi que la façon de contribuer de l'équipe eNovance. Idées pour tout de suite identification des éléments à prendre en compte pour pouvoir faire grandir des équipes distribuées organisation d'un projet open source, source d'inspiration pour l'organisation des projets informatiques d'une DSI innovation ouverte et gestion de produits

Technical_Update_GermanyBogdan Doinea

Establishing an Open Source Program Office

Lee Calcote

Cloud Foundry Foundation Overview

Cloud Foundry Foundation

A Reference Architecture to Enable Visibility and Traceability across the Ent...

CollabNet

Software development should not be a “black box” to the business, customers or other developers. Instead collaboration across stakeholders should be the norm--business, development and operations teams. Forrester recently reported that 13% of organizations doing Agile link “upstream” agile planning with ‘“downstream” development. As a result, executives continue to have only limited or no visibility beyond the initial planning stage of what is in a particular release. It’s not their fault, because today’s tools focus on upfront planning and don’t give you visibility into what’s happening in development. Often times that visibility is too late resulting in software that gets delivered and does not meet the customer’s needs. Join CollabNet’s most experienced senior solution architects as they explain how you can you gain real time visibility into all stages of the development process—from ideation into production through deployment. Imagine what can your teams get done if all stakeholders are able to collaborate together and view real time feeds into all stages of the delivery pipelines within a single easy-to-use system. Who Should attend: Any executive or manager interested in learning how to get traceability and visibility across the enterprise-- particularly, into the build and release management functions of their application lifecycle. What will be covered: An enterprise-scalable reference architecture for CI, CD, and DevOps The importance of build management, release management and application release automation integration A blueprint for scaling business agility across a large development organization How does CollabNet help organizations solve these problems A demonstration of TeamForge’s capabilities using Git/Gerrit, Code Review, Jenkins, Nexus, Artifactory, Chef and Automic

The Agile and Open Source Way (AgileTour Brussels)

Alexis Monville

Slides from AgileTour Brussels presentation on September 27th, 2013. More information on AgileTour Brussels: http://atbru.be/ The Agile and Open Source Way is the book for everyone who wants to scale agile in multiple distributed teams. This book will also help you to collaborate upstream with Open Source projects. Whether you want to improve interactions with other teams inside or outside your company, or just interested in scaling from more than one team, you will find in this publication the information you need, illustrated by a real case. http://www.the-agile-and-open-source-way.com/

Docs as Code: Publishing Processes for API Experiences

Anne Gentle

When you treat docs like code, you multiply everyone’s efforts and streamline processes through collaboration, automation, and plain old hard work. To create a cohesive API experience, developers, technical marketing engineers, technical writers, and product managers can work together on GitHub to produce web pages and API documentation, including interactive API docs and tutorials. The ways you can leverage developer processes and tools in a docs-as-code system vary widely. Let's walk through some examples including tools, version control, publishing workflows, approvals, source formats, checklists, automated testing, and final approval. Also, let's take some time to share some of the pitfalls and difficulties possible when you work on API and tools documentation for a large and varied product catalog with more than a thousand contributors.

Similar to Developing Docs for OpenDaylight (20)

DEVNET-1149 Leveraging Rapid Development with PaaS on Cisco Cloud

Cisco Spark and Tropo and the Programmable Web

Spring Tools 4 - Eclipse and Beyond

Keynote upload

The Cisco Intranet Case Study by Todd West

Getting Started with OpenStack

Cisco Spark – Collaboration Tool to facilitate for e-Learning

Nonprofit Homepage Design Slam - 10 tips for Effective Homepage Design

ScrumDay 2014 - Développer des produits avec des équipes distribuées - Alexis...

CI/CD pipeline security from start to finish with WhiteSource & CircleCI

IBM and OpenStack: Collaboration Beyond the Code

Essentials of Open Source Documentation

DEVNET-1125 Partner Case Study - “Project Hybrid Engineer”

Mix-IT - Des Produits avec des Equipes Distribuées

Technical_Update_Germany

Establishing an Open Source Program Office

Cloud Foundry Foundation Overview

A Reference Architecture to Enable Visibility and Traceability across the Ent...

The Agile and Open Source Way (AgileTour Brussels)

Docs as Code: Publishing Processes for API Experiences

More from Cisco DevNet

How to Contribute to Ansible

Cisco DevNet

Rome 2017: Building advanced voice assistants and chat bots

Cisco DevNet

If it takes minutes to code a simple bot, building professional bots represents quite a challenge. Soon you realize you need serious programming and API architecture experience but also “Bot” specific skills. In this session, we'll first show the code of advanced Chat and Voice interactions, and then explore the challenges faced when building advanced Bots (Context storage, NLP approaches, Bot Metadata, OAuth scopes), and discuss interesting opportunities from latest industry trends (Bot platforms, Serverless, Microservices). This talk is about showing the code and sharing lessons learned.

How to Build Advanced Voice Assistants and Chatbots

Cisco DevNet

Device Programmability with Cisco Plug-n-Play Solution

Cisco DevNet

Cisco Open Plug-n-Play solution allows customers to reduce the costs associated with deployment/installation of network devices, increase the speed and reduce the complexity of deployments without compromising the security. Using Cisco Plug-n-Play solution, customers can do Zero Touch Installs of Cisco gear in various deployment scenarios and deployment locations. Watch the DevNet 2052 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=91108&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Building a WiFi Hotspot with NodeJS: Cisco Meraki - ExCap API

Cisco DevNet

Captive Portals, also known as Splash Pages, are a common requirement for guest WiFi. Captive portals typically deliver branding, a terms of service and a simple login process before authenticating the client onto the network. By leveraging the Meraki ExCap API, developers can customize this experience based on their requirements. This deep dive will walk through the various API options: Click-through vs Sign-on Splash page Programming a Click-through and Sign-on (w/ RADIUS) using NodeJS Programming a Click-through with Node-RED Leveraging OAuth for social login support. Watch the DevNet 2049 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92727&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Application Visibility and Experience through Flexible Netflow

Cisco DevNet

The world of applications is changing rapidly in the enterprise; from the way applications are increasingly hosted in the cloud, the diverse nature of apps and to the way they are consumed by many devices. The need for organizations and network administrators is to focus on "Fast IT" - "Innovation in the Enterprise" is growing, which means having to spend less time on daily operations, maintenance and troubleshooting and more time on delivering business value with newer services. Cisco AVC with its NBAR2 technology is designed to detect applications and measure application performance through measuring round trip time, retransmission rates, jitter, delay, packet loss, MoS, URL statistics etc. Those details are transmitted using Flexible Netflow/IPFIX, so partners could leverage the data for application usage reporting, performance reporting and troubleshooting application issues to deliver best possible application experience. Watch the DevNet 2047 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92664&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

WAN Automation Engine API Deep Dive

Cisco DevNet

The WAN Automation Engine (WAE) is a software platform that provides multivendor and multilayer visibility and analysis for service provider and large enterprise networks. It plays a critical role in answering key questions of network resource availability, and when appropriate can automate and simplify Traffic Engineering mechanisms such as RSVP-TE and Segment Routing. This session will focus on use-cases and APIs for developers. Watch the DevNet 2035 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92720&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Cisco's Open Device Programmability Strategy: Open Discussion

Cisco DevNet

Cisco DNA is an open and extensible, software-driven architecture built on a set of design principles with the objective of providing: - Insights & Actions to drive faster business innovation - Automaton & Assurance to lower IT costs and complexity while meeting business and user expectations - Security & Compliance to reduce risk as the organization continues to expand and grow. The architecture extends to Cisco network elements. This session will focus on the open, model-driven, programmable interfaces available across Cisco's network elements which enable you to leverage and extend your network through applications that directly access the routers and switches in your network. Watch the DevNet 1028 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=91041&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Open Device Programmability: Hands-on Intro to RESTCONF (and a bit of NETCONF)

Cisco DevNet

In this small group, hands-on workshop session you'll learn how to write your first Python application that uses YANG, NETCONF and , RESTCONF to access operational and configuration data on a device. Watch the DevNet 2044 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92725&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

NETCONF & YANG Enablement of Network Devices

Cisco DevNet

A technical discussion and a demo showing how Tail-f's ConfD management agent can be used to implement NETCONF and YANG, the industry-leading solution for providing a programmable management interface in a network element. ConfD is recognized as the best-in-breed embedded software for implementing management functions in network elements, including physical devices and virtualized network functions (VNF) for NFV. This Workshop is a best fit for engineers who are involved in the design and development of embedded software for network devices. Attendees will gain a basic understanding of what NETCONF and YANG are and how ConfD provides a solution for embedding this technology in the network devices. More information about ConfD can be found at: https://developer.cisco.com/site/confD/ Watch the DevNet 1216 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92703&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

UCS Management APIs A Technical Deep Dive

Cisco DevNet

Underneath the UCS API Python SDK, Powershell Libraries and VMware and OpenStack plugins there is the UCS XML API itself. This session will go deep into the API and explain how the SDK, Libraries and plugins actually communicate with UCS components. We will cover API session management, queries, query filters, configuration methods, functions and event subscription. Understanding the low-level UCS APIs and Object Model will enable you to build your own programmatic interface into your UCS environments in the language you like on the platform of your choosing. Watch the DevNet 3003 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=91099&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

OpenStack Enabling DevOps

Cisco DevNet

The DevOps model is rapidly transforming IT operations and development practices. But what are the precursors necessary to implement DevOps? To achieve an agile, virtualized, and highly automated IT environment, what technological requirements need to be in place? OpenStack has the potential to facilitate DevOps implementation and practices at several different layers in the data center. In this session we'll quickly discuss what DevOps is, then discuss many components that are logically required to move towards DevOps in your environment. Finally we'll explore in depth several ways OpenStack can provide these baseline components. Watch the DevNet 1104 replay from the Cisco Live On-Demand Library at: https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=92695&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

NetDevOps for the Network Dude: How to get started with API's, Ansible and Py...

Cisco DevNet

Getting Started: Developing Tropo Applications

Cisco DevNet

What is Tropo, how do you use it, and what can you use it for? In this session, you'll learn how Tropo works, see some real-life examples, and learn how to create your own voice and SMS applications in minutes. Watch the DevNet 1023 replay from the Cisco Live On-Demand Library at:https://www.ciscolive.com/online/connect/sessionDetail.ww?SESSION_ID=91050&backBtn=true Check out more and register for Cisco DevNet: http://ow.ly/jCNV3030OfS

Cisco Spark & Tropo API Workshop

Cisco DevNet

Coding 102 REST API Basics Using Spark

Cisco DevNet

Cisco APIs: An Interactive Assistant for the Web2Day Developer Conference

Cisco DevNet

DevNet Express - Spark & Tropo API - Lisbon May 2016

Cisco DevNet

DevNet @TAG - Spark & Tropo APIs - Milan/Rome May 2016

Cisco DevNet

Choosing PaaS: Cisco and Open Source Options: an overview

Cisco DevNet

A session in the DevNet Zone at Cisco Live, Berlin. Confused by all the open source PaaS options out there? What criteria should you use to evaluate them? We seek to answer these questions in a systematic manner and will explore top technologies such as Mesos, Apprenda, Cloud Foundry and Kubernetes along with Cisco's Project Shipped and open source Mantl. The aim of this session will be to shed light on which platforms add value to your needs, applications and workloads.

More from Cisco DevNet (20)

How to Contribute to Ansible

Rome 2017: Building advanced voice assistants and chat bots

How to Build Advanced Voice Assistants and Chatbots

Device Programmability with Cisco Plug-n-Play Solution

Building a WiFi Hotspot with NodeJS: Cisco Meraki - ExCap API

Application Visibility and Experience through Flexible Netflow

WAN Automation Engine API Deep Dive

Cisco's Open Device Programmability Strategy: Open Discussion

Open Device Programmability: Hands-on Intro to RESTCONF (and a bit of NETCONF)

NETCONF & YANG Enablement of Network Devices

UCS Management APIs A Technical Deep Dive

OpenStack Enabling DevOps

NetDevOps for the Network Dude: How to get started with API's, Ansible and Py...

Getting Started: Developing Tropo Applications

Cisco Spark & Tropo API Workshop

Coding 102 REST API Basics Using Spark

Cisco APIs: An Interactive Assistant for the Web2Day Developer Conference

DevNet Express - Spark & Tropo API - Lisbon May 2016

DevNet @TAG - Spark & Tropo APIs - Milan/Rome May 2016

Choosing PaaS: Cisco and Open Source Options: an overview

Recently uploaded

Securing your Kubernetes cluster_ a step-by-step guide to success !

KatiaHIMEUR1

Today, after several years of existence, an extremely active community and an ultra-dynamic ecosystem, Kubernetes has established itself as the de facto standard in container orchestration. Thanks to a wide range of managed services, it has never been so easy to set up a ready-to-use Kubernetes cluster. However, this ease of use means that the subject of security in Kubernetes is often left for later, or even neglected. This exposes companies to significant risks. In this talk, I'll show you step-by-step how to secure your Kubernetes cluster for greater peace of mind and reliability.

Pushing the limits of ePRTC: 100ns holdover for 100 days

Adtran

Essentials of Automations: The Art of Triggers and Actions in FME

Safe Software

In this second installment of our Essentials of Automations webinar series, we’ll explore the landscape of triggers and actions, guiding you through the nuances of authoring and adapting workspaces for seamless automations. Gain an understanding of the full spectrum of triggers and actions available in FME, empowering you to enhance your workspaces for efficient automation. We’ll kick things off by showcasing the most commonly used event-based triggers, introducing you to various automation workflows like manual triggers, schedules, directory watchers, and more. Plus, see how these elements play out in real scenarios. Whether you’re tweaking your current setup or building from the ground up, this session will arm you with the tools and insights needed to transform your FME usage into a powerhouse of productivity. Join us to discover effective strategies that simplify complex processes, enhancing your productivity and transforming your data management practices with FME. Let’s turn complexity into clarity and make your workspaces work wonders!

DevOps and Testing slides at DASA Connect

Kari Kakkonen

Free Complete Python - A step towards Data Science

RinaMondal9

GraphSummit Singapore | The Future of Agility: Supercharging Digital Transfor...

Neo4j

Leonard Jayamohan, Partner & Generative AI Lead, Deloitte This keynote will reveal how Deloitte leverages Neo4j’s graph power for groundbreaking digital twin solutions, achieving a staggering 100x performance boost. Discover the essential role knowledge graphs play in successful generative AI implementations. Plus, get an exclusive look at an innovative Neo4j + Generative AI solution Deloitte is developing in-house.

Microsoft - Power Platform_G.Aspiotis.pdf

Uni Systems S.M.S.A.

Generative AI Deep Dive: Advancing from Proof of Concept to Production

Aggregage

Removing Uninteresting Bytes in Software Fuzzing

Aftab Hussain

Imagine a world where software fuzzing, the process of mutating bytes in test seeds to uncover hidden and erroneous program behaviors, becomes faster and more effective. A lot depends on the initial seeds, which can significantly dictate the trajectory of a fuzzing campaign, particularly in terms of how long it takes to uncover interesting behaviour in your code. We introduce DIAR, a technique designed to speedup fuzzing campaigns by pinpointing and eliminating those uninteresting bytes in the seeds. Picture this: instead of wasting valuable resources on meaningless mutations in large, bloated seeds, DIAR removes the unnecessary bytes, streamlining the entire process. In this work, we equipped AFL, a popular fuzzer, with DIAR and examined two critical Linux libraries -- Libxml's xmllint, a tool for parsing xml documents, and Binutil's readelf, an essential debugging and security analysis command-line tool used to display detailed information about ELF (Executable and Linkable Format). Our preliminary results show that AFL+DIAR does not only discover new paths more quickly but also achieves higher coverage overall. This work thus showcases how starting with lean and optimized seeds can lead to faster, more comprehensive fuzzing campaigns -- and DIAR helps you find such seeds. - These are slides of the talk given at IEEE International Conference on Software Testing Verification and Validation Workshop, ICSTW 2022.

LF Energy Webinar: Electrical Grid Modelling and Simulation Through PowSyBl -...

DanBrown980551

Do you want to learn how to model and simulate an electrical network from scratch in under an hour? Then welcome to this PowSyBl workshop, hosted by Rte, the French Transmission System Operator (TSO)! During the webinar, you will discover the PowSyBl ecosystem as well as handle and study an electrical network through an interactive Python notebook. PowSyBl is an open source project hosted by LF Energy, which offers a comprehensive set of features for electrical grid modelling and simulation. Among other advanced features, PowSyBl provides: - A fully editable and extendable library for grid component modelling; - Visualization tools to display your network; - Grid simulation tools, such as power flows, security analyses (with or without remedial actions) and sensitivity analyses; The framework is mostly written in Java, with a Python binding so that Python developers can access PowSyBl functionalities as well. What you will learn during the webinar: - For beginners: discover PowSyBl's functionalities through a quick general presentation and the notebook, without needing any expert coding skills; - For advanced developers: master the skills to efficiently apply PowSyBl functionalities to your real-world scenarios.

Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI

Vladimir Iglovikov, Ph.D.

Presented by Vladimir Iglovikov: - https://www.linkedin.com/in/iglovikov/ - https://x.com/viglovikov - https://www.instagram.com/ternaus/ This presentation delves into the journey of Albumentations.ai, a highly successful open-source library for data augmentation. Created out of a necessity for superior performance in Kaggle competitions, Albumentations has grown to become a widely used tool among data scientists and machine learning practitioners. This case study covers various aspects, including: People: The contributors and community that have supported Albumentations. Metrics: The success indicators such as downloads, daily active users, GitHub stars, and financial contributions. Challenges: The hurdles in monetizing open-source projects and measuring user engagement. Development Practices: Best practices for creating, maintaining, and scaling open-source libraries, including code hygiene, CI/CD, and fast iteration. Community Building: Strategies for making adoption easy, iterating quickly, and fostering a vibrant, engaged community. Marketing: Both online and offline marketing tactics, focusing on real, impactful interactions and collaborations. Mental Health: Maintaining balance and not feeling pressured by user demands. Key insights include the importance of automation, making the adoption process seamless, and leveraging offline interactions for marketing. The presentation also emphasizes the need for continuous small improvements and building a friendly, inclusive community that contributes to the project's growth. Vladimir Iglovikov brings his extensive experience as a Kaggle Grandmaster, ex-Staff ML Engineer at Lyft, sharing valuable lessons and practical advice for anyone looking to enhance the adoption of their open-source projects. Explore more about Albumentations and join the community at: GitHub: https://github.com/albumentations-team/albumentations Website: https://albumentations.ai/ LinkedIn: https://www.linkedin.com/company/100504475 Twitter: https://x.com/albumentations

Uni Systems Copilot event_05062024_C.Vlachos.pdf

Uni Systems S.M.S.A.

The Art of the Pitch: WordPress Relationships and Sales

Laura Byrne

Clients don’t know what they don’t know. What web solutions are right for them? How does WordPress come into the picture? How do you make sure you understand scope and timeline? What do you do if sometime changes? All these questions and more will be explored as we talk about matching clients’ needs with what your agency offers without pulling teeth or pulling your hair out. Practical tips, and strategies for successful relationship building that leads to closing the deal.

Artificial Intelligence for XMLDevelopment

Octavian Nadolu

In the rapidly evolving landscape of technologies, XML continues to play a vital role in structuring, storing, and transporting data across diverse systems. The recent advancements in artificial intelligence (AI) present new methodologies for enhancing XML development workflows, introducing efficiency, automation, and intelligent capabilities. This presentation will outline the scope and perspective of utilizing AI in XML development. The potential benefits and the possible pitfalls will be highlighted, providing a balanced view of the subject. We will explore the capabilities of AI in understanding XML markup languages and autonomously creating structured XML content. Additionally, we will examine the capacity of AI to enrich plain text with appropriate XML markup. Practical examples and methodological guidelines will be provided to elucidate how AI can be effectively prompted to interpret and generate accurate XML markup. Further emphasis will be placed on the role of AI in developing XSLT, or schemas such as XSD and Schematron. We will address the techniques and strategies adopted to create prompts for generating code, explaining code, or refactoring the code, and the results achieved. The discussion will extend to how AI can be used to transform XML content. In particular, the focus will be on the use of AI XPath extension functions in XSLT, Schematron, Schematron Quick Fixes, or for XML content refactoring. The presentation aims to deliver a comprehensive overview of AI usage in XML development, providing attendees with the necessary knowledge to make informed decisions. Whether you’re at the early stages of adopting AI or considering integrating it in advanced XML development, this presentation will cover all levels of expertise. By highlighting the potential advantages and challenges of integrating AI with XML development tools and languages, the presentation seeks to inspire thoughtful conversation around the future of XML development. We’ll not only delve into the technical aspects of AI-powered XML development but also discuss practical implications and possible future directions.

Elizabeth Buie - Older adults: Are we really designing for our future selves?

Nexer Digital

Why You Should Replace Windows 11 with Nitrux Linux 3.5.0 for enhanced perfor...

SOFTTECHHUB

The choice of an operating system plays a pivotal role in shaping our computing experience. For decades, Microsoft's Windows has dominated the market, offering a familiar and widely adopted platform for personal and professional use. However, as technological advancements continue to push the boundaries of innovation, alternative operating systems have emerged, challenging the status quo and offering users a fresh perspective on computing. One such alternative that has garnered significant attention and acclaim is Nitrux Linux 3.5.0, a sleek, powerful, and user-friendly Linux distribution that promises to redefine the way we interact with our devices. With its focus on performance, security, and customization, Nitrux Linux presents a compelling case for those seeking to break free from the constraints of proprietary software and embrace the freedom and flexibility of open-source computing.

PCI PIN Basics Webinar from the Controlcase Team

ControlCase

UiPath Test Automation using UiPath Test Suite series, part 6

DianaGray10

Welcome to UiPath Test Automation using UiPath Test Suite series part 6. In this session, we will cover Test Automation with generative AI and Open AI. UiPath Test Automation with generative AI and Open AI webinar offers an in-depth exploration of leveraging cutting-edge technologies for test automation within the UiPath platform. Attendees will delve into the integration of generative AI, a test automation solution, with Open AI advanced natural language processing capabilities. Throughout the session, participants will discover how this synergy empowers testers to automate repetitive tasks, enhance testing accuracy, and expedite the software testing life cycle. Topics covered include the seamless integration process, practical use cases, and the benefits of harnessing AI-driven automation for UiPath testing initiatives. By attending this webinar, testers, and automation professionals can gain valuable insights into harnessing the power of AI to optimize their test automation workflows within the UiPath ecosystem, ultimately driving efficiency and quality in software development processes. What will you get from this session? 1. Insights into integrating generative AI. 2. Understanding how this integration enhances test automation within the UiPath platform 3. Practical demonstrations 4. Exploration of real-world use cases illustrating the benefits of AI-driven test automation for UiPath Topics covered: What is generative AI Test Automation with generative AI and Open AI. UiPath integration with generative AI Speaker: Deepak Rai, Automation Practice Lead, Boundaryless Group and UiPath MVP

FIDO Alliance Osaka Seminar: The WebAuthn API and Discoverable Credentials.pdf

FIDO Alliance

Video Streaming: Then, Now, and in the Future

Alpen-Adria-Universität

In his public lecture, Christian Timmerer provides insights into the fascinating history of video streaming, starting from its humble beginnings before YouTube to the groundbreaking technologies that now dominate platforms like Netflix and ORF ON. Timmerer also presents provocative contributions of his own that have significantly influenced the industry. He concludes by looking at future challenges and invites the audience to join in a discussion.

Recently uploaded (20)

Securing your Kubernetes cluster_ a step-by-step guide to success !

Pushing the limits of ePRTC: 100ns holdover for 100 days

Essentials of Automations: The Art of Triggers and Actions in FME

DevOps and Testing slides at DASA Connect

Free Complete Python - A step towards Data Science

GraphSummit Singapore | The Future of Agility: Supercharging Digital Transfor...

Microsoft - Power Platform_G.Aspiotis.pdf

Generative AI Deep Dive: Advancing from Proof of Concept to Production

Removing Uninteresting Bytes in Software Fuzzing

LF Energy Webinar: Electrical Grid Modelling and Simulation Through PowSyBl -...

Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI

Uni Systems Copilot event_05062024_C.Vlachos.pdf

The Art of the Pitch: WordPress Relationships and Sales

Artificial Intelligence for XMLDevelopment

Elizabeth Buie - Older adults: Are we really designing for our future selves?

Why You Should Replace Windows 11 with Nitrux Linux 3.5.0 for enhanced perfor...

PCI PIN Basics Webinar from the Controlcase Team

UiPath Test Automation using UiPath Test Suite series, part 6

FIDO Alliance Osaka Seminar: The WebAuthn API and Discoverable Credentials.pdf

Video Streaming: Then, Now, and in the Future

Developing Docs for OpenDaylight

2. Open-Source Content Development in OpenDaylight Paul Zimmerman Manager, NOSTG Developer Content

6. The Story So Far

10. Moving Forward

11. © 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public “Professional” Doc Set • Three main types: – Structured product documentation (installation, user guides) – Auto-generated documentation (API references) – Project documentation (specs, plans) • Consistency • Consolidated topics • Better Search • Higher expectations

14. © 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public Tooling Structure Topic Topic Topic Topic Topic Maven BitBucket Repository OpenDaylight Site Develop Review Revise

15. © 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public Authoring • AsciiDoc mark-up language • Easy markup for developers • Easy to adapt from MediaWiki • Checked in and out like code

17. © 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public Next Steps • Finalize tooling • Create similar look & feel for autogenerated content • Clean up wiki • Develop community

18. Challenges

19. • “Your Life as a Developer” Survey 2013 JFrog Artifactory “65% of developers from over 150 Fortune 500 companies cited documentation as one of the biggest challenges of open-source software”

20. © 2014 Cisco and/or its affiliates. All rights reserved.Presentation_ID Cisco Public Documentation Struggles Open Source • Focus on software • Team effort on docs OpenDaylight • Planning for future distributions • Catch-up • Resources

22. Thank you.

Developing Docs for OpenDaylight

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (20)

Similar to Developing Docs for OpenDaylight

Similar to Developing Docs for OpenDaylight (20)

More from Cisco DevNet

More from Cisco DevNet (20)

Recently uploaded

Recently uploaded (20)

Developing Docs for OpenDaylight