A good article on developing large systems

[Ron Wheeler]

https://dzone.com/storage/assets/6002108-dzone-guidetointegration-volumeiv.pdf 
has on page 7:


"The philosophy behind DocumentationDriven API Design or Development is 
simple: from the perspective of a user, if a feature is not documented, 
then it does not exist, and if a feature is documented incorrectly, then 
it is broken."


also

DOCUMENT YOUR API OR FEATURE FIRST
You can do this as you design an API, or later if you’d like to rework 
an existing API. Wherever the documentation becomes complicated or 
difficult to write, revisit the design. This process works because it is 
easier to spot complexity in the documentation than in the code.
Figure out how you are going to describe the feature to users; if it is 
not documented, it does not exist.


DO DOCUMENTATION REVIEWS
Whenever possible, documentation should be reviewed by users before any 
development begins. This also gives you the chance to get your ideas 
peer-reviewed, since it helps users to understand what you are trying to do.


WORK IN PARALLEL
Once documentation has been written, development should commence, 
preferably test-driven development. Both developers and testers can 
start working on the implementation, one focusing on writing code and 
the other on writing automatic tests.


 TESTING
Unit tests should be written to test the features as described in the 
documentation. If the functionality is ever out of alignment with the 
documentation, tests should fail.


 CHANGES
When a feature is being modified, it should be modified 
documentation-first; when documentation is modified, so should the tests 
change. Along with the tests being changed, the coding will also have to 
be modified accordingly.


VERSIONING
Documentation and software should both be versioned, and the versions 
should match so someone working with old versions of software will be 
able to find the proper documentation."



This would seem to make evaluating PRs a lot easier. 3 sets of PRs would 
be have to approved but the approval of each one would be much easier 
and involve a lot less risk.
We would also have much better documentation, much clearer Release Notes 
and full coverage of the test suite.


It would also expand the community by increasing the visibility of 
enhancement project and giving more opportunities for people to get 
involved in testing and coding of enhancements. People who might not 
feel comfortable developing the code might be quite willing to take on 
testing if they wanted to help gt a new feature implemented.



Ron

--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Re: [DISCUSS] CloudStack 4.9.3.0 (LTS)

[Rohit Yadav]

All,


We've helped with several PR reviews and merges recently, both in 4.9 and 
master.

We'll stop accepting any changes by end of next week (18 August), afterwards 
we'll only accept test and blocker fixes blocking the release.


Feel free to suggest any commits/fixes/PRs we should consider towards 4.9.3.0.


Following satisfactory test results (both Travis, Trillian and others) on 4.9 
branch we'll cut 4.9.3.0 RC1 for voting.


Regards.


From: Sean Lair 
Sent: Tuesday, July 25, 2017 1:05:56 AM
To: dev@cloudstack.apache.org; us...@cloudstack.apache.org
Subject: RE: [DISCUSS] CloudStack 4.9.3.0 (LTS)

Hi Rohit

I previous suggested these for 4.9.3.0

https://github.com/apache/cloudstack/pull/2041 (VR related jobs scheduled and 
run twice on mgmt servers)
https://github.com/apache/cloudstack/pull/2040 (Bug in monitoring of S2S VPNs - 
also exists in 4.10)
https://github.com/apache/cloudstack/pull/1966 (IPSEC VPNs do not work after 
vRouter reboot)

I'd also like to suggest these:
https://github.com/apache/cloudstack/pull/1246 (unable to use reserved IP range 
in a network)
https://github.com/apache/cloudstack/pull/2201 (VPC VR doesn't respond to DNS 
requests from remote access vpn clients)


Thanks
Sean

rohit.ya...@shapeblue.com 
www.shapeblue.com
53 Chandos Place, Covent Garden, London  WC2N 4HSUK
@shapeblue
  
 


-Original Message-
From: Rohit Yadav [mailto:rohit.ya...@shapeblue.com]
Sent: Monday, July 24, 2017 5:56 AM
To: dev@cloudstack.apache.org; us...@cloudstack.apache.org
Subject: Re: [DISCUSS] CloudStack 4.9.3.0 (LTS)

All,


We'll accept bugfixes on 4.9 branch till end of next week, following which I'll 
start release work towards 4.9.3.0 (LTS) release. Please help review 
outstanding PRs, share PRs that we should consider and advise/suggest issues 
that need to be reverted/backported, for example see: 
https://github.com/apache/cloudstack/pull/2052


Thank you for your support and co-operation.


- Rohit


From: Rohit Yadav 
Sent: Sunday, July 23, 2017 1:26:48 PM
To: dev@cloudstack.apache.org; us...@cloudstack.apache.org
Subject: Re: [DISCUSS] CloudStack 4.9.3.0 (LTS)

All,


I've started looking into reviewing/testing/merging of the PRs targeting 4.9+, 
I'll share some plans around 4.9.3.0 soon. Meanwhile, help in reporting any 
major/critical bugs and PRs we should consider reviewing/testing/merging. 
Thanks.


- Rohit

rohit.ya...@shapeblue.com
www.shapeblue.com
53 Chandos Place, Covent Garden, London  WC2N 4HSUK @shapeblue




rohit.ya...@shapeblue.com
www.shapeblue.com
53 Chandos Place, Covent Garden, London  WC2N 4HSUK @shapeblue

Re: Introduction

[Syed Ahmed]

Welcome to the community Nicolas!

On Tue, Aug 1, 2017 at 1:48 PM, ilya  wrote:

> Welcome!
>
> On 7/31/17 8:07 AM, Nicolas Vazquez wrote:
> > Hi all,
> >
> >
> > My name is Nicolas Vazquez, today is my first day at @ShapeBlue as a
> Software Engineer. I am based in Montevideo, Uruguay and I've been working
> with CloudStack since mid-2015. Looking forward to working with you!
> >
> >
> > Thanks,
> >
> > Nicolas
> >
> > nicolas.vazq...@shapeblue.com
> > www.shapeblue.com
> > ,
> > @shapeblue
> >
> >
> >
> >
>