From 5be54990e7f01adcba0acbf0de4593345eabaf1e Mon Sep 17 00:00:00 2001 From: Jeff Wilcox Date: Fri, 22 Feb 2013 17:41:13 -0800 Subject: [PATCH 1/4] addressing feedback #1 --- css/azureopensource.css | 20 ++++++++++++++++++++ guidelines.html | 27 ++++++++++++++------------- 2 files changed, 34 insertions(+), 13 deletions(-) diff --git a/css/azureopensource.css b/css/azureopensource.css index f7b3925..e0e5e09 100644 --- a/css/azureopensource.css +++ b/css/azureopensource.css @@ -9,3 +9,23 @@ body { code { color: #333; } + +h3 { + font-size: 24.5px; + color: #777; +} + +h1 { + padding-bottom: 20px; +} + +.nav-tabs > .active > a { + background-color: #eee; + color: #333; +} + +.nav-tabs > .active > a:hover { + background-color: #eee; + color: #333; +} + diff --git a/guidelines.html b/guidelines.html index fe7a58e..d41933b 100644 --- a/guidelines.html +++ b/guidelines.html @@ -88,7 +88,8 @@
-

Ways to contribute

+

Let's work together.

+

Ways to contribute

If you would like to become involved in the development of Windows Azure SDKs and Tools there are many different ways @@ -120,7 +121,7 @@

Ways to contribute

-

Get the source code

+

Get the source code

Our source is developed & published on GitHub.com (learn more). @@ -151,7 +152,7 @@

Get the source code

-

Q&A forums

+

Q&A forums

The easiest way to ask questions is to use the Windows Azure SDK and Tools forums @@ -163,7 +164,7 @@

Q&A forums

-

Reporting bugs & issues

+

Reporting bugs & issues

Issues and feature requests are submitted through the project's Issues section on GitHub. Please use the following guidelines when @@ -195,7 +196,7 @@

Reporting bugs & issues

-

Feature requests

+

Feature requests

@@ -299,7 +300,7 @@

Contributing code

-

Contribution License Agreement (CLA)

+

Contribution License Agreement (CLA)

In order to become a contributor to the Windows Azure open source projects on GitHub you must follow some @@ -314,7 +315,7 @@

Contribution License Agreement (CLA)

  • Microsoft FTE
  • Microsoft Partner Team
    • -
    +
    @@ -455,7 +456,7 @@

    Fixing bugs

    -

    Code Reviews

    +

    Code Reviews

    tbd @@ -463,16 +464,16 @@

    Code Reviews

    -

    Contact the team

    +

    Contact the team

    -

    tbd

    +

    Detailed support and contact information »

    -

    Jobs

    +

    Jobs

    Microsoft is always hiring bright and talented students & professionals. Please consider submitting your resume and @@ -481,10 +482,10 @@

    Jobs

    - +
    -

    Thank you

    +

    Thank you

    Huge thanks go to the contributors from the community who From b5f378690ba1f6df9ada0374cb5f3e52d4fbf7bb Mon Sep 17 00:00:00 2001 From: Jeff Wilcox Date: Fri, 22 Feb 2013 18:02:04 -0800 Subject: [PATCH 2/4] more iteration --- contact.html | 3 +- guidelines.html | 75 +++++++++++++++++++++++++++++++++++++++---------- projects.html | 2 ++ 3 files changed, 63 insertions(+), 17 deletions(-) diff --git a/contact.html b/contact.html index 1fab916..e4877ec 100644 --- a/contact.html +++ b/contact.html @@ -62,8 +62,7 @@

    -

    Support & Contacts

    -

    Let's get in touch.

    +

    Let's get in touch.

    Forum Support

    You'll find that the community on the Internet is probably the best diff --git a/guidelines.html b/guidelines.html index d41933b..7f13a50 100644 --- a/guidelines.html +++ b/guidelines.html @@ -79,10 +79,9 @@

  • Step-by-step
  • Code reviews
  • Contact the team
    • +
  • Our contributors
  • Join our team
  • Azure is hiring
    • -
  • -
  • Our contributors
    • @@ -161,6 +160,33 @@

    Q&A forums

    For all other languages please use StackOverflow.

    + + + + + + + + + + + + + + + + + + + + + +
    Forum ProviderTagsNotes
    StackOverflow

    StackOverflow

    		azureA friendly, open and fun community of developers.
    Microsoft Forums for Windows Azure

    Microsoft forums

    		A good place for support and feedback on Windows Azure features + and services like Web Sites, Mobile Services, etc.
    +
    @@ -335,6 +361,13 @@

    Contribution License Agreement (CLA)

    You can download the Contribution License Agreement (CLA) by clicking the following link: http://windowsazure.github.com/docs/Contribution License Agreement.pdf.

    + +

    + Download the Contribution License Agreement (CLA)
    + 281 KB PDF

    +

    Please fill in, sign, scan & email the completed document to Contribution License Agreement (CLA) open source projects & meet your shipping criteria, please start engaging our triad early.

    -

    TODO: Links

    +

    Our SharePoint site contains plenty of information on + the onboarding process, timelines and contacts.

    + +

    + Open Windows Azure SDK SharePoint
    + Requires corporate credentials

    @@ -466,10 +505,28 @@

    Code Reviews

    Contact the team

    +

    The best way to get in touch with the team regarding feature ideas, + developer designs amd communicating about bug fixes is to use the Issues system + built in to GitHub.

    + +

    If you are looking for support or to provide feedback, there are a lot of + places to do this.

    +

    Detailed support and contact information »

    + +
    +

    Thank you

    + +

    + Huge thanks go to the contributors from the community who + have been actively working with the Windows Azure SDK team. +

    +

    You can find a list of contributors here. +

    +
    @@ -481,18 +538,6 @@

    Jobs

    //careers.microsoft.com.

    - -
    - -
    -

    Thank you

    - -

    - Huge thanks go to the contributors from the community who - have been actively working with the Windows Azure SDK team. -

    -

    You can find a list of contributors here. -

    diff --git a/projects.html b/projects.html index 970585a..82d5535 100644 --- a/projects.html +++ b/projects.html @@ -62,6 +62,8 @@
    +

    Projects & SDKs

    +

    This page contains information about the open source aspect of many of the Windows Azure SDKs, frameworks & tools. If you want to use the released versions of these products to develop your applications, From 0c46957f3fd03fa1aed8d29bb6bf17789d41c282 Mon Sep 17 00:00:00 2001 From: Jeff Wilcox Date: Fri, 22 Feb 2013 18:06:13 -0800 Subject: [PATCH 3/4] typos --- guidelines.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/guidelines.html b/guidelines.html index 7f13a50..9b030db 100644 --- a/guidelines.html +++ b/guidelines.html @@ -397,7 +397,8 @@

    Contribution License Agreement (CLA)

    If your Microsoft team is looking to partner with the Windows Azure SDK team to ship new bits, create new open source projects & meet your shipping - criteria, please start engaging our triad early.

    + criteria, please start engaging the Windows Azure SDK + triad early.

    Our SharePoint site contains plenty of information on the onboarding process, timelines and contacts.

    @@ -512,7 +513,7 @@

    Contact the team

    If you are looking for support or to provide feedback, there are a lot of places to do this.

    -

    Detailed support and contact information »

    +

    Detailed support and contact information »

    From a803a106bc73bdf8ad415e3e8ebab30d093224dd Mon Sep 17 00:00:00 2001 From: Jeff Wilcox Date: Mon, 25 Feb 2013 11:04:08 -0800 Subject: [PATCH 4/4] iterative improvements --- _template.html | 1 + contact.html | 1 + css/azureopensource.css | 3 + guidelines.html | 158 +++++++++++++++++++++++++--------------- index.html | 5 +- js/azure.js | 19 +++++ projects.html | 1 + thanks.html | 1 + 8 files changed, 128 insertions(+), 61 deletions(-) create mode 100644 js/azure.js diff --git a/_template.html b/_template.html index 929ee8d..77bf7a8 100644 --- a/_template.html +++ b/_template.html @@ -38,6 +38,7 @@
  • Projects
      +
    • All projects
    • Software Dev Kits
    • .NET SDK
    • Node.js SDK
      • diff --git a/contact.html b/contact.html index e4877ec..7610486 100644 --- a/contact.html +++ b/contact.html @@ -38,6 +38,7 @@
    • Projects
        +
      • All projects
      • Software Dev Kits
      • .NET SDK
      • Node.js SDK
        • diff --git a/css/azureopensource.css b/css/azureopensource.css index e0e5e09..ba99f6e 100644 --- a/css/azureopensource.css +++ b/css/azureopensource.css @@ -29,3 +29,6 @@ h1 { color: #333; } +xx-section { + padding-top: 20px; +} \ No newline at end of file diff --git a/guidelines.html b/guidelines.html index 9b030db..e64e7da 100644 --- a/guidelines.html +++ b/guidelines.html @@ -18,7 +18,7 @@ - +
        @@ -39,6 +39,7 @@
      • Projects
          +
        • All projects
        • Software Dev Kits
        • .NET SDK
        • Node.js SDK
          • @@ -66,7 +67,7 @@
          -
            +
            • Ways to contribute
            • Community member
            • Source code
              • @@ -88,17 +89,19 @@

              Let's work together.

              -

              Ways to contribute

              + +

              Ways to contribute

              +

              If you would like to become involved in the development of Windows Azure SDKs and Tools there are many different ways in which you can contribute. We strongly value your feedback, questions, bug reports, and feature requests. -

              +

              -

              - Consider these options: -

              +

              + Consider these options: +

              • Use the products
                • @@ -123,31 +126,36 @@

                Ways to contribute

                Get the source code

                Our source is developed & published on GitHub.com - (learn more). -

                -

                If you are new to Git, - check out the - Pro Git Book online or at - your bookseller of choice.

                -

                We - have based our development process for moving code - around on the now-classic - Successful Git Branching Model - as well as using GitHub pull requests and forks between the - central organization repository and developer accounts.

                + (learn more). If you are + new to Git, + check out the + Pro Git Book online or at + your bookseller of choice. +

                +

                + We have based our development process for moving code + around on the now-classic + Successful Git Branching Model + as well as using GitHub pull requests and forks between the + central organization repository and developer accounts. +

                From any of the Windows Azure code repositories on GitHub, you can "Fork" the code to your own account.

                -

                To get the source on your local development machine, +

                + To get the source on your local development machine, simply clone the repo using Git:
                - git clone https://github.com/USERNAME/PROJECT.git -

                + git clone https://github.com/USERNAME/PROJECT.git +

                + +

                + Each repository has a README that should be helpful to + learn more about the specifics of the language, project + and its development environment. +

                -

                Each repository has a README that should be helpful to - learn more about the specifics of the language, project - and its development environment.

              @@ -161,31 +169,31 @@

              Q&A forums

              For all other languages please use StackOverflow.

              - - - - - - - - - - - - - - - - - - - - -
              Forum ProviderTagsNotes
              StackOverflow

              StackOverflow

              		azureA friendly, open and fun community of developers.
              Microsoft Forums for Windows Azure

              Microsoft forums

              		A good place for support and feedback on Windows Azure features - and services like Web Sites, Mobile Services, etc.
              + + + + + + + + + + + + + + + + + + + + +
              Forum ProviderTagsNotes
              StackOverflow

              StackOverflow

              		azureA friendly, open and fun community of developers.
              Microsoft Forums for Windows Azure

              Microsoft forums

              		A good place for support and feedback on Windows Azure features + and services like Web Sites, Mobile Services, etc.
              @@ -198,33 +206,64 @@

              Reporting bugs & issues

                -
              • Make sure the issue is not already reported by searching - through the list of issues
                • -
              • Provide detailed description of the issue including the - following information:
                • +
              • + Make sure the issue is not already reported by searching + through the list of issues +
                • +
              • + Provide detailed description of the issue including the + following information:
                • Which feature the issue appears in
                • Under what circumstances the issue appears
                • What is desired behavior
                • What is breaking
                  • -
                • What is the impact (things like loss or corruption of data, - compromizing security, disruption of service etc.)
                  +
                • + What is the impact (things like loss or corruption of data, + compromizing security, disruption of service etc.)
                • Any code that will be helpful to reproduce the issue
                +

              Issues are regularly reviewed and updated with additional - information by the core team. Sometimes the core team may have - questions about particular issue that might need clarifications - so, please be ready to provide additional information.
              + information by the core team. Sometimes the core team may have + questions about particular issue that might need clarifications + so, please be ready to provide additional information.

              Feature requests

              + Feature requests and Design Change Requests (DCRs) are an important part of + the lifecycle of any software project. Please log these as Issues in the + appropriate GitHub repository.

              +

              + Although the team will consider any opened issues, please keep in mind + that there is an extremely high bar when it comes to expanding the scope + and functionality of a core product such as an SDK for Windows Azure. +

              +

              + When opening any feature requests, consider including as much information + as possible, including: +

              +
                +
              • Detailed scenarios enabled by the feature or DCR.
                • +
              • Information about your use case or additional value your + business or site will see from the feature.
                • +
              • Any design tips or estimation ideas you may have considered already.
                • +
              • Make note of whether you are opening an issue you would + like the Microsoft team or another community member to work on or + if you are looking to design & develop the feature + yourself.
                • +
              • Any potential caveats or concerns you may have already + thought about.
                • +
              • A miniature test plan or list of test scenarios is always + helpful.
                • +
              @@ -570,6 +609,7 @@

              Jobs

              + \ No newline at end of file diff --git a/index.html b/index.html index 5da360c..8a915ad 100644 --- a/index.html +++ b/index.html @@ -38,14 +38,15 @@
            • Projects
                -
              • Software Dev Kits
                • +
              • All projects
                • +
              • Software dev Kits
              • .NET SDK
              • Node.js SDK
              • Java SDK
              • PHP SDK
              • Python SDK
              • -
              • More Projects
                • +
              • More projects
              • iisnode
              • WindowsAzure.com
                • diff --git a/js/azure.js b/js/azure.js new file mode 100644 index 0000000..ddb2327 --- /dev/null +++ b/js/azure.js @@ -0,0 +1,19 @@ +!function ($) { + + $(function(){ + + var $window = $(window) + + // side bar + setTimeout(function () { + $('.azure-nav-list').affix({ + offset: { + top: function () { return $window.width() <= 980 ? 290 : 210 } + , bottom: 270 + } + }) + }, 100) + + }) + +}(window.jQuery) \ No newline at end of file diff --git a/projects.html b/projects.html index 82d5535..ad2f185 100644 --- a/projects.html +++ b/projects.html @@ -38,6 +38,7 @@
              • Projects