Contribuir a la documentación de Dynamics 365
Puede contribuir a la documentación de Microsoft para Dynamics 365 de dos maneras. Si un artículo contiene información incorrecta o confusa, o si conoce una solución eficaz para un problema recurrente, puede utilizar el vínculo de comentarios en el artículo para indicárnoslo.
Para la mayoría de nuestra documentación, también puede editar un artículo directamente para iniciar un proceso de revisión.
Proporcionar comentarios
En el sitio web learn.microsoft.com, cada artículo de Learn ofrece la oportunidad de proporcionar comentarios. Puede elegir la acción Comentarios que se encuentra debajo del título del artículo en la parte superior derecha o una de las opciones de comentarios en la parte inferior del artículo en la sección Comentarios. Proporcione una clasificación para el artículo, seleccione el motivo de su comentario y considere dejar un comentario. Los comentarios se envían al autor del artículo y al equipo propietario de los documentos.
Si un artículo no se puede editar directamente, o si no se siente cómodo editándolo, le recomendamos que utilice el mecanismo de comentarios para decirnos lo que piensa sobre el artículo. o el producto.
Contribuciones externas a la documentación de Microsoft
Los archivos de origen para nuestro contenido principal se almacenan en repositorios públicos de GitHub. Cualquiera puede revisarlos y, en muchos casos, editarlos. Agradecemos sus sugerencias y correcciones, ya sea en forma de contribuciones directas o como problemas de GitHub para informar de un error o hacer una pregunta. Solo podemos aceptar comentarios y contribuciones relativos al contenido de origen en inglés.
La mayoría de los artículos tienen un icono de lápiz con la información sobre herramientas Editar este documento. Seleccione el icono para abrir el artículo en GitHub y luego comience a editarlo. Comience como colaborador con la Guía del colaborador de Microsoft Learn.
Si quiere profundizar y contribuir con nuevos artículos conceptuales, use las plantillas en https://github.com/MicrosoftDocs/dynamics365-docs-templates.
Contenido de las instrucciones de Dynamics 365
El contenido de las instrucciones de Dynamics 365 utiliza los mismos procesos que la mayoría de la documentación de Microsoft Learn. En esta sección, destacamos herramientas y procesos que puede utilizar para ayudar a complementar la guía de implementación.
El término contenido de las instrucciones cubre la guía de implementación de Dynamics 365, descripciones de procesos de negocio, nuevos patrones, procedimientos recomendados y arquitecturas de referencia. Hemos publicado la primera ronda de contenido de las instrucciones en abril de 2023 y agregamos actualizaciones cada dos semanas. Explore al centro de orientación y cuéntenos qué es genial y qué falta.
Parte del contenido de las instrucciones lo proporcionan colaboradores internos. Animamos a los expertos en la materia de toda la comunidad a que nos ayuden a establecer los procedimientos recomendados. Siga leyendo si tiene un procedimiento recomendado u otra idea que cree que debería ser parte de Microsoft Learn.
¿Por qué colaborar?
Confiamos en que el nuevo contenido de las instrucciones ayude a ejecutar los proyectos de implementación de Dynamics 365 con mayor rapidez. Nuestros partners y clientes pueden utilizar las instrucciones para prepararse para la implementación y mejorar las habilidades en nuevas áreas o mejorar las habilidades del personal nuevo. Los desarrolladores de software pueden utilizar el contenido como plataforma para promover su propiedad intelectual o experiencia en el sector.
Pero en Microsoft no somos los únicos expertos en la implementación de soluciones con Dynamics 365. En la comunidad hay muchas personas expertas en varios aspectos de la implementación. ¿Tiene un patrón, un procedimiento recomendado, una configuración o una arquitectura de integración que funcione bien en varias implementaciones? Considere compartirlo aquí en Microsoft Learn para que toda la comunidad sea aún más productiva y eficiente en sus proyectos de implementación.
Esperamos poder ofrecer recompensas u otros reconocimientos por contribuciones con el tiempo. En 2023, reconocemos a los colaboradores en los artículos.
Cómo colaborar
A partir de noviembre de 2023, puede encontrar los archivos de origen del contenido de las instrucciones de Dynamics 365 de Microsoft en un repositorio público de GitHub. También puede editar los artículos en el sitio learn.microsoft.com/dynamics365/guidance como se describe en la Guía del colaborador de Microsoft Learn.
Le recomendamos que envíe las correcciones de la misma manera que envía una corrección a otras áreas de Microsoft Learn. Sin embargo, para enviar nuevo contenido, le pedimos que cargue sus archivos Markdown para obtener nuevo contenido de instrucciones en un repositorio diferente, Dynamics 365 Patterns and Practices. De esta manera, podemos asegurarnos de que otros expertos en la materia revisan su arquitectura de referencia o patrón. Hay diferentes plantillas entre las que elegir, y si desea contribuir al contenido del proceso empresarial, hay un proceso totalmente diferente.
Plantillas
Microsoft proporciona plantillas en dos ubicaciones, según el tipo de plantilla:
Las plantillas de Markdown están en el repositorio de https://github.com/MicrosoftDocs/dynamics365-docs-templates.
La carpeta docs-templates contiene plantillas para artículos conceptuales y de navegación.
La carpeta /guidance-templates/ contiene plantillas para arquitecturas, ideas de soluciones y patrones. Estas plantillas son las mismas que se usan en Microsoft, pero se han creado de manera específica para Dynamics 365.
Las plantillas de Word y PowerPoint se encuentran en el repositorio Dynamics 365 Patterns and Practices.
La carpeta /templates/business-processes/ contiene plantillas de Word para los artículos de proceso empresariales. Invitamos a todos los expertos en la materia a que nos ayuden a escribirlos. La carpeta también contiene un archivo de Excel con la lista de procesos de negocio que hemos identificado. La lista irá cambiando con el tiempo.
La carpeta /graphics/ contiene archivos de PowerPoint para cada escenario de un extremo, al que puede agregar sus propios diagramas.
También iremos agregando más plantillas e instrucciones con el tiempo. Le recomendamos que siga los repositorios o que los guarde con una estrella, para recibir notificaciones cuando algo cambie.
Comparta sus comentarios en la pestaña https://github.com/microsoft/dynamics365patternspractices/discussions en el repositorio de Dynamics 365 Patterns and Practices.
Si aún no tiene una cuenta de GitHub, comience con la guía del colaborador de Microsoft Learn.
Sugerencia
Explore nuestros archivos de origen en el repositorio https://github.com/MicrosoftDocs/dynamics365-guidance. Aprenda de la forma en que estructuramos los diferentes tipos de artículos para que estos sigan la misma estructura. De esa manera, el proceso de revisión se ejecuta más rápido.
Arquitecturas
Serán bien recibidas las contribuciones de instrucciones de arquitectura, como ideas de soluciones y patrones de diseño. Si tiene una práctica recomendada o una implementación de referencia, envíe su propuesta al equipo de Azure o a nosotros en Dynamics 365.
Siga estos pasos principales para contribuir con nuevos artículos a las instrucciones de arquitectura de Dynamics 365:
- Obtenga las plantillas Markdown adecuadas de la carpeta guidance-templates del repositorio de GitHub dynamics365-docs-templates.
- Escriba sus contribuciones.
- Envíe su artículo como archivo Markdown en una solicitud de incorporación de cambios al repositorio dynamics365patternspractices. La carpeta
/submit-architecture/está lista para recibir sus contribuciones.
Microsoft procesa el artículo y lo publica como parte de la documentación de instrucciones de Dynamics 365.
Para obtener una introducción general al contenido de orientación en Microsoft, consulte el Centro de arquitectura de Azure. Para obtener la guía del colaborador, consulte Colaboraciones para el Centro de arquitectura de Azure.
El repositorio de GitHub dynamics365-docs-templates contiene las siguientes plantillas Markdown para instrucciones de arquitectura en la carpeta guidance-templates:
Patrón de arquitectura generalizado: un patrón de arquitectura generalizado actúa como una arquitectura central con una solución común que se aplica a muchos escenarios. Por ejemplo, las ideas de solución pueden desarrollarse a partir de un artículo de arquitectura para proporcionar una perspectiva para un sector en particular o una solución para partners, y vincularse a la arquitectura desde cada idea de solución. La plantilla se basa en la plantilla de la Guía de arquitectura de Azure. Úsela para diferentes tipos de arquitecturas, incluidas las arquitecturas de referencia.
Idea de solución: las ideas de solución son arquitecturas "pequeñas" de implementaciones de Dynamics 365. Proporcionan breves descripciones generales de soluciones con servicios de Dynamics 365 y Azure. Cada idea de solución contiene los siguientes elementos:
- Un diagrama de arquitectura
- Un flujo de datos
- Componentes, es decir, una lista de los servicios utilizados
- Créditos de colaborador
- Vínculos a los próximos pasos y recursos relacionados, como guías y arquitecturas relacionadas
Solución de ejemplo: las soluciones de ejemplo son cargas de trabajo de ejemplo con arquitecturas "medianas". Guían a los lectores a través del proceso de diseño de soluciones para problemas específicos en las implementaciones de Dynamics 365. Las soluciones de muestra ofrecen una guía de arquitectura procesable basada en ejemplos reales de clientes. El objetivo es acortar la curva de aprendizaje de los clientes al contarles la historia de otro que estuvo en el mismo recorrido. Incluyen las secciones de la plantilla Idea de solución y agregan las siguientes secciones:
- Alternativas, otros servicios que puede conectar a la arquitectura en su lugar
- Consideraciones, orientación que se relaciona con nuestro marco de Success by Design y, opcionalmente, incluye una implementación
Modelo de diseño: los modelos de diseño de Dynamics 365 abordan desafíos específicos en las implementaciones y se basan en un escenario o procedimiento recomendado específicos. Utilice esta plantilla para capturar un modelo de proceso de negocio. Alternativamente, use la plantilla de Word en dynamics365patternspractices/templates/business-processes.
Contribuciones a los procesos de negocio
El término procesos de negocio abarca una amplia gama de actividades o tareas estructuradas, a menudo secuenciadas, para lograr un objetivo organizativo predeterminado. El término también puede referirse a los efectos acumulados de todos los pasos que llevan a un objetivo empresarial. Los procesos de negocio son particulares de las soluciones que incluyen Dynamics 365. Creemos que este nuevo tipo de contenido crea una estructura que ayuda a los clientes y partners a estar mejor preparados para adoptar Dynamics 365. Cada proceso de negocio incluye un diagrama de un flujo de proceso de negocio estándar. En las secciones del documento se describen los pasos de configuración y las entidades de datos que se utilizan para cada uno. Cada paso se vincula a la página relevante en la documentación del producto, y todos los documentos tienen vínculos a los siguientes pasos y recursos relacionados para ayudar a los lectores a lo largo de su recorrido de aprendizaje.
Estructuramos los procesos de negocio en un catálogo. El catálogo de procesos de negocio es un libro de Excel que utilizamos en Microsoft para organizar y priorizar nuestro trabajo en la documentación de procesos de negocio. El formato es Excel porque facilita la ordenación y el filtrado de las entradas. También creemos que nuestros partners pueden utilizar el libro de Excel para organizar sus procesos de incorporación, sus proyectos de implementación y sus propios procesos de negocio.
Descargue la versión más reciente del catálogo en https://aka.ms/BusinessProcessCatalog.
Nota
Si desea contribuir a los procesos de negocio, registre su trabajo antes de comenzar a reducir el riesgo de que alguien más esté trabajando en el mismo proceso de negocio. Para registrar su trabajo, envíe una incidencia de GitHub a https://github.com/microsoft/dynamics365patternspractices/issues.
Contenido del catálogo
El catálogo define cuatro niveles de contenido:
Procesos integrales
Hemos identificado 15 escenarios integrales. Describimos los escenarios en términos empresariales, no en términos de tecnología de software.
En el artículo introductorio de cada proceso integral se describe lo que pensamos del mismo. Mostramos las partes interesadas clave y cómo Dynamics 365 ayuda en el proceso integral. También ofrecemos información general, junto con un programa de flujo de proceso de negocio, de cómo interactúa el proceso integral con otros procesos integrales. La introducción presenta los requisitos previos para implementar una solución que admita el proceso integral.
Áreas de proceso de negocio
Cada escenario integral abarca dos o más áreas de proceso de negocio. Este nivel es solo una forma de agrupar los procesos de negocio para facilitar la búsqueda y la navegación. En la mayoría de los casos, las áreas de proceso de negocio se dividen por departamentos o funciones de trabajo principales en una organización. Actualmente, el catálogo define más de 90 áreas de procesos de negocio.
Procesos de negocio
El término procesos de negocio abarca una amplia gama de actividades o tareas estructuradas, a menudo secuenciadas, para lograr un objetivo organizativo predeterminado. El término también puede referirse a los efectos acumulados de todos los pasos que llevan a un objetivo empresarial. Cada proceso de negocio describe una función o proceso que admite Dynamics 365. Hasta ahora, hemos identificado casi 700 procesos de negocio. Algunos hacen referencia a una sola aplicación de Dynamics 365 y es posible que la documentación de esa aplicación ya describa el proceso. La intención de recopilar todos los procesos de negocio aquí en esta guía es ofrecer un único punto de entrada con vínculos al contenido pertinente específico de cada producto.
Patrones
En Dynamics 365, los patrones son configuraciones repetibles que admiten un proceso de negocio específico. Incluyen los casos de uso, escenarios y sectores más comunes. Suele haber muchas maneras de implementar Dynamics 365 para cumplir con los requisitos de cada negocio. El objeto de los patrones es proporcionar una línea de base para la implementación. Hemos identificado más de 2000 patrones y esperamos que ese número crezca significativamente con el tiempo.
Obtenga más información sobre el catálogo de procesos de negocio en Acerca de la guía de procesos de negocio.
Enviar su contribución
En Microsoft estamos haciendo un gran esfuerzo para convertir notas internas, años de experiencia y varios documentos en la guía de procesos de negocio. Agradecemos mucho las contribuciones de la comunidad.
Existen diferentes plantillas para enviar contribuciones según el tipo de artículo. Los colaboradores deben elegir la plantilla adecuada para el tipo apropiado de artículo en el que desean contribuir. Las plantillas están disponibles como archivos de Word cuyo nombre explica para qué tipo de artículo están destinadas.
Reconocimiento a los colaboradores
La plataforma de Microsoft Learn muestra tanto los colaboradores internos como los externos en la parte superior de cada artículo si enviaron su colaboración a través de GitHub. Algunas personas colaboran de otras formas, de modo que agregamos la sección Colaboradores hacia el final del artículo.
La sección opcional Colaboradores incluye los colaboradores clave con su nombre y un vínculo a su perfil de LinkedIn u otro perfil si han proporcionado uno. La siguiente captura de pantalla es una versión anónima de la sección Colaboradores en un artículo del Centro de arquitectura de Azure.
Así es como se ve en Markdown:
## Contributors
*This article is maintained by Microsoft. It was originally written by the following contributors.*
Principal author:
* [Author's Name](https://www.linkedin.com/in/author-account/) | Author's job title or similar
Other contributors:
* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar
* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar
Aparecer como colaborador de esta forma es opcional. En Microsoft, recomendamos usar la sección Colaboradores si los colaboradores externos envían contenido nuevo, como arquitecturas de referencia y patrones de diseño, a través de otros medios que no sean GitHub.