Repository files navigation

IPDs are a shrink-to-fit description of larger scale (in either code size orimpact) project wishing to make changes to illumos. They should describe thewhat and the why and give people the opportunity to comment on both.

An IPD is at its heart, just a README.md in a numbered directory in thisrepository, existing IPDs are enumerated below for easy reference. Furtherinformation is available at the end of this document.

Contributions are welcome. A good rule of thumb as to whether youshouldhave an IPD is whether you are making a change with high impact to otherdevelopers or users (introducing or removing a supported platform, doingsomething with non-obvious compatibility constraints), or engaging in along-term project that will likely integrate in pieces, to provide the overallpicture.

For your first contribution, you might want to just submit a pull request tothis repository. Going forward if this is a thing that you will do again,we'll probably give you write access to this repository so you can just addyour new IPDs as they come up.

An IPD has a short header block indicating authorship (that's you),sponsorship (we'll get to that), and state.

You've started writing your IPD and you want to share it narrowly, or evenjust to reserve your a number in this repository. You'repredraft, maybeyou only have a title and a short paragraph right now, that's fine.

You've finished writing and explaining, and now you're going to send your IPDto thedeveloper mailing list, this is adraft, you're going to receive feedback so it's not complete, but it's close.

One or more people from theillumos coreteam have agreed that what you'vedescribed is a good thing, and that we should do it. Your IPD is done andpublished (though is not immutable! If you find more information would beuseful later, please add it!)

"Sponsor" is a weird word here, it's just the person or people on the illumoscore team who were ok with your IPD. Don't worry about it.