Tuesday, November 18, 2025
Sunday, November 9, 2025
Wednesday, November 5, 2025
Por qué la documentación debe vivir junto al código
Esa idea proviene de una práctica común en ingeniería de software y desarrollo ágil.
Martin Fowler — En sus artículos sobre "Self-Documenting Code" y "Continuous Integration", Fowler sugiere que la documentación debe estar “lo más cerca posible del código” para mantenerse actualizada y Fowler promueve documentar dentro del código (por ejemplo, con comentarios o docstrings), o en el mismo repositorio (por ejemplo, usando README o Markdown junto al código fuente).
Kent Beck — En Extreme Programming Explained, Beck también insiste en que la mejor documentación es el código mismo, y que cualquier documentación adicional debe estar “junto al código que describe” para evitar que quede obsoleta.
Joel Spolsky — En su ensayo “Where does documentation live?”, Joel recomienda mantener la documentación cerca del código en el control de versiones, por la misma razón: coherencia y mantenimiento.
Sunday, November 2, 2025
Wednesday, October 29, 2025
Develop event-based solutions - Labs
Materiales:
Exercise 1: Create Azure resources
- Task 1: Open the Azure portal
- Task 2: Open Azure Cloud Shell
- Task 3: Review Microsoft.EventGrid provider registration
- Task 4: Create a custom Event Grid topic
- Task 5: Deploy the Azure Event Grid viewer to a web app
- Review of Exercise 1
Exercise 2: Create an Event Grid subscription
- Task 1: Access the Event Grid Viewer web application
- Task 2: Create a new subscription
- Task 3: Observe the subscription validation event
- Task 4: Record subscription credentials
- Review of Exercise 2
Exercise 3: Publish Event Grid events from .NET
- Task 1: Create a .NET project
- Task 2: Modify the Program class to connect to Event Grid
- Task 3: Publish new events
- Task 4: Observe published events
- Review of Exercise 3
Subscribe to:
Comments (Atom)