Mostrar mensagens com a etiqueta T19. Mostrar todas as mensagens
Mostrar mensagens com a etiqueta T19. Mostrar todas as mensagens

sexta-feira, 23 de junho de 2017

DIGEST: Modelling Tools tasks and Sparx Systems EA Documentation (UML Modelling Tool)

And the proper freshly linked links are indeed these ones:

  • Modelling tasks (what do I need to be able to do to be a modeller?): http://silvaonsoftware.blogspot.pt/2016/07/tools-modelling-tools-hot-topics.html
Is this enough?

quinta-feira, 22 de junho de 2017

Static Analysis: What to Measure? And How?

In Static Analysis how and what should we measure?
It depends on what we want to analyze and / or control with this verification method.
If you want to know some reasons why it is important to be done, read here (static analysis - why).

How? 

The ideal scenario is to choose the right tool for the job you have to do (as always). This is the how. The tool ideally integrates with your favorite IDE (e.g. Checkstyle plugin for Eclipse, see more info here) so that features are readily available without tool and additional context changes.

What? 

Tools already measure things during static analysis and will allow you to do some kind of fine tuning on the KPI thresholds (e.g. minimum value for the measure, maximum value).

There are lots of papers (and standards) on what to measure to achieve, for instance, maintainability.

Examples of measures:
- LOC
- % comments
- Cyclomatic Complexity
- Max. Depth
- Average Depth
- Etc.

For each programming language there could be different recommendations for the KPIs. Also have a look on what the "community" has to say about it (and to the tool defaults for that language). i.e. Google for it.

Additional Info

Some additional ideas:
You also have standards like AFP and AEP (from CISQ) that deal with these topics.




quarta-feira, 3 de maio de 2017

And the Fresh leafy Links are... (information repositories and support tools)

The recent relevant (and mostly INTERNAL) links are indeed these ones:

- (Internal) Training resources should be shared internally; the task could be handed to HR (accumulating also with the responsibility of managing assiduity and training metrics collection - #hours of training per year, per worker). Example: https://goo.gl/Hq06W6
  • Sometimes you'll be able to access the training in editable formats, sometimes only the PDF. Sometimes you'll get the session video with audio (interesting to hear the Q&A sections or if some parts of the PPT are not self-explanatory). That's life ;)
  • A training policy shall exist (you can see it here) and a published training plan shall exist (you can see one example here).

- Project Management Information System (or systems) (PMIS):
  • Companies will use several different stacks (with the intent of managing projects and controlling them). 
  • Effort reporting is one important input for Project Controllers and for Project Managers (that will analyse EVM indicators). When possible, to save time, remember to use recurrence (PMIS/Wise, "More options | Recurrence" link). But "handle with care": Some will have no undo, no delete recurrence.
- Documentation numbering: INTRA-DOC, Intradoc, IntraDoc, whatever and however they'll spell it.
It is a simple application with an important role: creating and centralizing the DOC ids that are being allocated throughout the company. The QMS Documentation Process (and several Quality Standards) requires this, and the process can be found here.

- Lessons learned (LL) database: It is a central repository of lessons learned (of type Strengths, Improvements and Weaknesses). Most of them are weaknesses. And the logic is to... learn from the past (and know for example how past projects have handled harsh situations).

It is also a QMS Process: QMS Lessons Learned Process which you can find here (and a guidebook explaining every field of a lesson learned as well as how to create them in the PMIS / WISE).

That's all. Please report any broken (INTERNAL) link.

(@2017-05-04, minor reformat and rephrases)

sexta-feira, 28 de abril de 2017

And the fresh links are...

... here:





segunda-feira, 21 de novembro de 2016

DIGEST: Requirements Analysis - Further Reading

Additional info on Requirements Analysis (and SW Requirements):
  1. The requirements analysis "film": http://silvaonsoftware.blogspot.pt/2016/05/process-software-requirements-team.html
  2. To learn some specifics: See your QMS "requirements standard" (INTERNAL; includes best practices and conventions). 
  3. Writing good requirements paper here (PDF)
  4. Requirement types: http://silvaonsoftware.blogspot.pt/2016/11/requirements-requirements-types.html
  5. For even further info: Read books on the subject and related subjects: Requirements analysis, requirements engineering, business process analysis (a broader topic), writing good requirements. "Google" and/or "Amazon" them. 
(@2016-11-23: Fixed link of Req. Std.; 2017-06-08: fixed link)

sexta-feira, 4 de novembro de 2016

Modelling: EA initial management tasks

Some common management tasks for EA (to be performed by the EA UML repository manager, which could be the Technical Manager of your project) include:

Activate Security - Turn on the option that allows you to define who alters what part of the model and who does not (lock, unlock):
http://www.sparxsystems.com/enterprise_architect_user_guide/8.0/projects_and_teams/usersecurity.html

Managing Users - Create profiles, users belonging to profiles and defining permissions for those:
http://www.sparxsystems.com/enterprise_architect_user_guide/8.0/projects_and_teams/managingusers.html

Import Users from Active Directory - Integrating existing (e.g. domain) users into EA 
http://www.sparxsystems.com/enterprise_architect_user_guide/8.0/projects_and_teams/import_user_ids_from_active_di.html

Initial EA Scripts - The DB schema that has to be loaded into the SQL DB initially: 
http://silvaonsoftware.blogspot.pt/2016/10/ea-initial-scripts.html


(@2017-06-23: Minor rephrases)

segunda-feira, 17 de outubro de 2016

DIGEST: Agile/Scrum links

Agile / Scrum recent relevant links include:
Additional resources related to Agile / Scrum:
The Tools Dept.: 
(Updated: 2016-10-20, PT BR link; minor rephrases; 2016-11-24: link to summary and minor rephrases; 2017-06-06: actionable book)


segunda-feira, 3 de outubro de 2016

quarta-feira, 27 de julho de 2016

RESOURCE: EA additional documentation

Sparx's Enterprise Architect (EA) UML Modelling Tool has loads of documentation in the WWW (aside from the local online help documentation that typically is very self-contained and informative). Several task-oriented docs exist and are made available via the WWW web site. Some interesting examples are presented here (direct links for download):

Reference Booklets (PDF List):
Getting Started:
Requirements management with EA:


Data Modelling:
UML additional resources: 

(Updated: @2016-10-10: Added version control PDF; 2018-03: updated broken links)

quinta-feira, 2 de junho de 2016

About the Product Vision

A vision and a Product Backlog: What is needed to start Scrum (according to one of the maintainers of the Scrum Official Guide).

About the Product Vision including some PV samples:


Product Vision Template:

Work through the PV template together with the key stakeholders in the same room:

"For <target customer>
Who needs <statement of the need or of the opportunity>
The <product name> is a <product category>
That <key benefit and/or reason to buy>
Unlike <primary competitive alternative>
Our product <statement of primary differentiation>"

Test the product vision statement with the elevator pitch (If you can’t pitch what you have in 30 seconds, your product vision isn’t still finished - rework it).


(@2017-05-29: Added PV template link/info)

quarta-feira, 4 de maio de 2016

BOOK: Code Complete (Steve McConnell)

Steve McConnell's Code Complete has been around helping developers building better software for a long time ago. Now on its second edition (Code Complete 2).

Quoting:
"Widely considered one of the best practical guides to programming, Steve McConnell’s original CODE COMPLETE has been helping developers write better software for more than a decade. Now this classic book has been fully updated and revised with leading-edge practices—and hundreds of new code samples—illustrating the art and science of software construction. Capturing the body of knowledge available from research, academia, and everyday commercial practice, McConnell synthesizes the most effective techniques and must-know principles into clear, pragmatic guidance. No matter what your experience level, development environment, or project size, this book will inform and stimulate your thinking—and help you build the highest quality code.
Discover the timeless techniques and strategies that help you:

  1. Design for minimum complexity and maximum creativity
  2. Reap the benefits of collaborative development
  3. Apply defensive programming techniques to reduce and flush out errors
  4. Exploit opportunities to refactor—or evolve—code, and do it safely
  5. Use construction practices that are right-weight for your project
  6. Debug problems quickly and effectively
  7. Resolve critical construction issues early and correctly
  8. Build quality into the beginning, middle, and end of your project"


Read all about it here: http://www.amazon.com/Code-Complete-Developer-Best-Practices-ebook/dp/B00JDMPOSY

(updated 2017-06-22: Back cover info)

sexta-feira, 11 de março de 2016

About Earned-Value Management (EVM)

The topic here is Software Development, but with time you'll learn that a team without management will under-perform (and this is more true for large teams).

Sometimes, if you're a software engineer (or product assurance engineer) you'll be on progress meetings where the project performance is being reviewed and some strange acronyms will start being referred (CPI, SPI, etc.).
Some of these are Earned-Value Management Indicators (EVM Indicators). What are these? Google will tell you. For now I'll just share with you these neat cheat sheets and/or summaries:

There are also good books for a jump start on these topics:
  • Project Management for Dummies (Stanley / Portny): Amazon.

PS. For a description of WISE EVM indicators please read the WISE Project Module Guidebook (INTERNAL). Examples of how they are shown internally to PMs can be seen here (INTERNAL).




PS. EVM is NOT enough for Project Monitoring and Control for certain levels of maturity as required by the Capability Maturity Model (CMMI). We'll need more on our QMS. More on this later on. One of these days.

(2016-05-12: Added book, WISE GBK, screenshot; 2017-05-02: shortened URL, minor rephrases)