Author: stevel
Date: Mon Aug 25 12:27:10 2014
New Revision: 1620306
URL: http://svn.apache.org/r1620306
Log:
SLIDER-86 windows dev notes
Added:
incubator/slider/site/trunk/content/developing/windows.md
Modified:
incubator/slider/site/trunk/content/developing/index.md
incubator/slider/site/trunk/content/developing/style.md
Modified: incubator/slider/site/trunk/content/developing/index.md
URL:
http://svn.apache.org/viewvc/incubator/slider/site/trunk/content/developing/index.md?rev=1620306&r1=1620305&r2=1620306&view=diff
==============================================================================
--- incubator/slider/site/trunk/content/developing/index.md (original)
+++ incubator/slider/site/trunk/content/developing/index.md Mon Aug 25 12:27:10
2014
@@ -29,6 +29,9 @@ Slider
* [Functional Testing](/developing/functional_tests.html)
* [Manual Testing](/developing/manual_testing.html)
* [Releasing](/developing/releasing.html)
+* [Releasing](/developing/releasing.html)
+* [Style Guide](/developing/style.html)
+* [Windows Development and Testing](/developing/windows.html)
Modified: incubator/slider/site/trunk/content/developing/style.md
URL:
http://svn.apache.org/viewvc/incubator/slider/site/trunk/content/developing/style.md?rev=1620306&r1=1620305&r2=1620306&view=diff
==============================================================================
--- incubator/slider/site/trunk/content/developing/style.md (original)
+++ incubator/slider/site/trunk/content/developing/style.md Mon Aug 25 12:27:10
2014
@@ -38,8 +38,12 @@ Java guidelines
* use groovy asserts over JUnit asserts âthe diagnostics are better.
* You can use `==` in assertions; Groovy maps it to `Object.equals()`. the
operator `is` is used for equality tests.
* to break up bits of a test run, use the {{describe()}} method to print out
the next action. This helps understand what is happening in a (noisy) output
stream.
-* avoid esoteric Groovy that isn't immediately obvious to developers with
minimal Groovy experience. For example, don't expect readers to know the rules
of how strings are evaluated to true or false in conditions, or the more
[esoteric operators|http://groovy.codehaus.org/Operators] such as 'spaceship'
or 'elvis'
+* avoid esoteric Groovy that isn't immediately obvious to developers with
minimal Groovy experience.
+Obscure bits of Groovy to avoid
+* the rules of how strings are evaluated to true or false in conditions, or
the more [esoteric operators|http://groovy.codehaus.org/Operators] such as
'spaceship' or 'elvis'
+* automatic return values of functions (except for very short ones)
+* applying actions across entire list elements. (if used: comment)
### Python
Added: incubator/slider/site/trunk/content/developing/windows.md
URL:
http://svn.apache.org/viewvc/incubator/slider/site/trunk/content/developing/windows.md?rev=1620306&view=auto
==============================================================================
--- incubator/slider/site/trunk/content/developing/windows.md (added)
+++ incubator/slider/site/trunk/content/developing/windows.md Mon Aug 25
12:27:10 2014
@@ -0,0 +1,55 @@
+<!---
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License. See accompanying LICENSE file.
+-->
+
+# Windows Development and Testing
+
+
+This documents what you need to build and test on Windows
+
+1. Windows server 2012
+1. Create an admin account for yourself
+1. take snapshots as you go along
+
+
+
+## Virtual Box
+
+1. Ask for lots of RAM
+2. 2D acceleration of video
+1. Critical: Enable PAE under "processor". this avoids random hangs.
+
+## Dev tools
+
+1. Bitvise SSH server; add your private key to the account you create.
+1. Git
+1. Java 7
+1. Everything Hadoop's `BUILDING.TXT` needs. This includes the gnu tools,
protoc,
+python and more. If you cannot build Hado
+1. PFE32 is still one of the best plain text editors for development around,
+even just for viewing logs & test results.
+1. Chrome can be used a browser instead of IE if you want âbut you should
still
+view all web pages in IE to verify they look OK.
+
+### Knowledge
+
+1. Knowledge of the [CMD.EXE command
line](http://technet.microsoft.com/en-us/library/bb490954.aspx)
+1. How to set `Path`.
+ i. In explorer, find "This PC"
+ i. right mouse button onto "properties"
+ i. then "advanced properties"
+ 1. then "Environment variables"
+ 1. then the user env vars ... scroll down to find path.
+ 1. copy the `Path` value, edit in PFE or similar, paste back in.
+ 1. Open a new command window.
+
\ No newline at end of file
