Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove incubator from the URL of the repositories #202

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.adoc
Expand Up @@ -56,11 +56,11 @@ You don't need the source code to use Apache Groovy but if you wish to explore i

Apache Groovy uses Git. The official Git repository is at:

http://git-wip-us.apache.org/repos/asf/incubator-groovy.git
https://git-wip-us.apache.org/repos/asf/groovy.git

And a mirror is hosted on Github:

https://github.com/apache/incubator-groovy
https://github.com/apache/groovy

The Github mirror is read-only and provides convenience to users and developers to explore the code and for the community to accept contributions via Github pull requests.

Expand Down
4 changes: 2 additions & 2 deletions config/checkstyle/checkstyle-report.groovy
Expand Up @@ -31,7 +31,7 @@ def severityMapping = [

def github = { path, line=null ->
def localPath = (path - project.rootDir).replaceAll('\\\\','/')
def link = """https://github.com/apache/incubator-groovy/blob/master$localPath${line?"#L$line":""}"""
def link = """https://github.com/apache/groovy/blob/master$localPath${line?"#L$line":""}"""

if (line) {
"<a href='$link'>$line</a>"
Expand Down Expand Up @@ -170,4 +170,4 @@ html {
}
}
}
}
}
6 changes: 3 additions & 3 deletions gradle/pomconfigurer.gradle
Expand Up @@ -590,9 +590,9 @@ project.ext.pomConfigureClosureWithoutTweaks = {
url 'http://issues.apache.org/jira/browse/GROOVY'
}
scm {
connection 'scm:git:https://github.com/apache/incubator-groovy.git'
developerConnection 'scm:git:https://github.com/apache/incubator-groovy.git'
url 'https://github.com/apache/incubator-groovy.git'
connection 'scm:git:https://github.com/apache/groovy.git'
developerConnection 'scm:git:https://github.com/apache/groovy.git'
url 'https://github.com/apache/groovy.git'
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion src/spec/doc/core-getting-started.adoc
Expand Up @@ -154,7 +154,7 @@ You may download other distributions of Groovy from https://bintray.com/groovy/m

=== Source Code

If you prefer to live on the bleeding edge, you can also grab the https://github.com/apache/incubator-groovy[source code from GitHub].
If you prefer to live on the bleeding edge, you can also grab the https://github.com/apache/groovy[source code from GitHub].

=== IDE plugin

Expand Down
2 changes: 1 addition & 1 deletion src/spec/doc/core-metaprogramming.adoc
Expand Up @@ -2663,7 +2663,7 @@ and such a thing rarely happens.

Classes of the Abstract Syntax Tree belong to the `org.codehaus.groovy.ast` package. It is recommended to the reader
to use the Groovy Console, in particular the AST browser tool, to gain knowledge about those classes. However, a good
resource for learning is the https://github.com/apache/incubator-groovy/tree/master/src/test/org/codehaus/groovy/ast/builder[AST Builder]
resource for learning is the https://github.com/apache/groovy/tree/master/src/test/org/codehaus/groovy/ast/builder[AST Builder]
test suite.

==== Testing AST transformations
Expand Down
2 changes: 1 addition & 1 deletion src/spec/doc/grape.adoc
Expand Up @@ -355,7 +355,7 @@ groovy -Dgrape.root=/repo/grape yourscript.groovy

You can customize the ivy settings that Grape uses by creating a
~/.groovy/grapeConfig.xml file. If no such file exists,
https://github.com/apache/incubator-groovy/blob/master/src/resources/groovy/grape/defaultGrapeConfig.xml[here]
https://github.com/apache/groovy/blob/master/src/resources/groovy/grape/defaultGrapeConfig.xml[here]
are the default settings used by Grape.

For more information on how to customize these settings, please refer to
Expand Down
56 changes: 28 additions & 28 deletions src/spec/doc/groovy-contributions.adoc
Expand Up @@ -75,7 +75,7 @@ You can find live icon:twitter[] https://twitter.com/hashtag/groovylang[#groovyl

=== Where is Groovy ?

Open source developers often need somewhere to keep all their assets. These assets are typically stored in a repository somewhere on the internet. icon:github[link="https://github.com/"] https://github.com/[*GitHub*] is one such storage facility. At *[blue]#Groovy#*, we keep https://github.com/apache/incubator-groovy[our _source code_ here].
Open source developers often need somewhere to keep all their assets. These assets are typically stored in a repository somewhere on the internet. icon:github[link="https://github.com/"] https://github.com/[*GitHub*] is one such storage facility. At *[blue]#Groovy#*, we keep https://github.com/apache/groovy[our _source code_ here].

Visit our *[blue]#Groovy#* information portal at image:assets/img/groovy.png[Groovy Website, 60, 30, link="http://groovy-lang.org/"]

Expand All @@ -96,7 +96,7 @@ Sometimes, you may spot a tiny flaw in our otherwise perfect product. It's buggi

[red yellow-background big]*Sure icon:exclamation[]*

Let's say you need to fix the [blue]#Groovy# README.adoc file in https://github.com/apache/incubator-groovy[https://github.com/apache/incubator-groovy] - our core location.
Let's say you need to fix the [blue]#Groovy# README.adoc file in https://github.com/apache/groovy[https://github.com/apache/groovy] - our core location.

'''

Expand All @@ -114,15 +114,15 @@ Your view should look like this, except it will say +groovy / groovy-core+ ( thi
'''

.README.adoc View
image::assets/img/example16.png[Details, align="center", link="https://github.com/apache/incubator-groovy/blob/master/README.adoc"]
image::assets/img/example16.png[Details, align="center", link="https://github.com/apache/groovy/blob/master/README.adoc"]

This view is the current content of the *README* file. You can see ( but not edit ) the raw text by clicking the +RAW+ button. But for this example, you want to change some text. The red arrow points to the editor *PENCIL*. Click that to open an editable version of this page. See below.


'''

.Groovy-core/README.adoc page
image::assets/img/example17.png[Details, align="center", link="https://github.com/apache/incubator-groovy/blob/master/README.adoc"]
image::assets/img/example17.png[Details, align="center", link="https://github.com/apache/groovy/blob/master/README.adoc"]

Confirm you're on the correct page ( blue square ). Then on line 80, after the words _Continuous Integration_ add the word _Server_

Expand All @@ -145,7 +145,7 @@ First we look at the home of [blue]#Groovy# . Then we review the structure and i

=== Notes About GitHub

At *[blue]#Groovy#*, we keep https://github.com/apache/incubator-groovy[our _source code_ here].
At *[blue]#Groovy#*, we keep https://github.com/apache/groovy[our _source code_ here].

==== GitHub Information

Expand Down Expand Up @@ -210,34 +210,34 @@ From here on, we've assumed you have logged into your own *GitHub* account.

==== Visit Groovy Core Repository on GitHub

Open a web browser, then use address https://github.com/apache/incubator-groovy[https://github.com/apache/incubator-groovy] to review the [blue]#Groovy# code base. It looks like this :
Open a web browser, then use address https://github.com/apache/groovy[https://github.com/apache/groovy] to review the [blue]#Groovy# code base. It looks like this :

.Groovy Core on *Github* icon:github[link="https://github.com/apache/incubator-groovy", window="_blank"]
image::assets/img/github4.png[Groovy Core Repository on GitHub, 495, 436, link="https://github.com/apache/incubator-groovy",align="center"]
.Groovy Core on *Github* icon:github[link="https://github.com/apache/groovy", window="_blank"]
image::assets/img/github4.png[Groovy Core Repository on GitHub, 495, 436, link="https://github.com/apache/groovy",align="center"]

There are a number of folders within the [blue]#Groovy# code base. The most important folders are */src* and */subprojects* as these folders hold the base code and scripts for [blue]#Groovy#.

==== The +/src+ Folder

The core of [blue]#Groovy# lives within this folder. Here is where we find a variety of artifacts, scripts, tests, resources, images, etc.

.Groovy Core Source Folder on *Github* icon:github[link="https://github.com/apache/incubator-groovy/tree/master/src", window="_blank"]
image::assets/img/github1.png[Groovy Core Source, 497, 313, link="https://github.com/apache/incubator-groovy/tree/master/src",align="center"]
.Groovy Core Source Folder on *Github* icon:github[link="https://github.com/apache/groovy/tree/master/src", window="_blank"]
image::assets/img/github1.png[Groovy Core Source, 497, 313, link="https://github.com/apache/groovy/tree/master/src",align="center"]


==== The +/subprojects+ Folder

[blue]#Groovy# has many additional features that are not part of the core system. Source code for these added features can be found in the *subprojects* folder. It looks something like this :

.Groovy Core Sub-Projects Source Folder on *Github* icon:github[link="https://github.com/apache/incubator-groovy/tree/master/subprojects", window="_blank"]
image::assets/img/github2.png[Groovy Core Source, 499, 397, link="https://github.com/apache/incubator-groovy/tree/master/subprojects",align="center"]
.Groovy Core Sub-Projects Source Folder on *Github* icon:github[link="https://github.com/apache/groovy/tree/master/subprojects", window="_blank"]
image::assets/img/github2.png[Groovy Core Source, 499, 397, link="https://github.com/apache/groovy/tree/master/subprojects",align="center"]

==== The Documentation Folder

Within each */src* and */subproject/src* is a */spec* documents folder that exists, or will soon be created.

.Groovy Document Specifications Folder on *Github* icon:github[link="https://github.com/apache/incubator-groovy/tree/master/src/spec", window="_blank"]
image::assets/img/github3.png[Groovy Documents Source, 500, 185, link="https://github.com/apache/incubator-groovy/tree/master/src/spec",align="center"]
.Groovy Document Specifications Folder on *Github* icon:github[link="https://github.com/apache/groovy/tree/master/src/spec", window="_blank"]
image::assets/img/github3.png[Groovy Documents Source, 500, 185, link="https://github.com/apache/groovy/tree/master/src/spec",align="center"]

The two most useful folders here are */doc* and */test*. These two folders hold our documents and test cases.

Expand All @@ -246,14 +246,14 @@ The two most useful folders here are */doc* and */test*. These two folders hold
All of our documents are written as typical text files encoded as *UTF-8* characters. The text is styled in the markup syntax known as http://asciidoctor.org/docs/user-manual/[*asciidoc*] or http://asciidoctor.org/docs/user-manual/[*asciidoctor*] ( the more recent version ). These text files have a filename suffix designation of *.adoc*.

.Groovy Documentation Folder on *Github*
image::assets/img/github5.png[Groovy Documents Folder, 501, 170, link="https://github.com/apache/incubator-groovy/tree/master/src/spec/doc",align="center"]
image::assets/img/github5.png[Groovy Documents Folder, 501, 170, link="https://github.com/apache/groovy/tree/master/src/spec/doc",align="center"]

===== Test Cases

To prove that [blue]#Groovy# modules work as expected, we often construct test cases that exercise code logic. These test cases are actually [blue]#Groovy# scripts that reside in the */test* folder.

.Groovy Core Test Folder on *Github* icon:github[link="https://github.com/apache/incubator-groovy/tree/master/src/spec/test", window="_blank"]
image::assets/img/github6.png[Groovy Testcase Folder, 505, 303, link="https://github.com/apache/incubator-groovy/tree/master/src/spec/test",align="center"]
.Groovy Core Test Folder on *Github* icon:github[link="https://github.com/apache/groovy/tree/master/src/spec/test", window="_blank"]
image::assets/img/github6.png[Groovy Testcase Folder, 505, 303, link="https://github.com/apache/groovy/tree/master/src/spec/test",align="center"]

If you would like to know more about writing effective test cases, please http://groovy-lang.org/testing.html[review this link].

Expand Down Expand Up @@ -287,16 +287,16 @@ Ok, let's look for the *groovy-core* repository. In the field named +Search or t
'''

.Fork Groovy Core on *GitHub*
image::assets/img/githubfork.png[Fork The Code, 541, 156, link="https://github.com/apache/incubator-groovy",align="center"]
image::assets/img/githubfork.png[Fork The Code, 541, 156, link="https://github.com/apache/groovy",align="center"]

So you can work on your own version of [blue]#Groovy#, you'll need to make a copy of it. This copy is placed in your own *GitHub* account under your credentials. This task of making a copy is known as *Fork* -ing.

Check you're logged into your own *GitHub* account before you start to search.

Fork the https://github.com/apache/incubator-groovy[groovy/groovy-core] repository on *GitHub* to your own *GitHub* account. Click the +Fork+ button while on the *groovy/groovy-core* panel. When you look at your own *GitHub* home page, you'll see the list of your forked repos and any new repos you make.
Fork the https://github.com/apache/groovy[groovy/groovy-core] repository on *GitHub* to your own *GitHub* account. Click the +Fork+ button while on the *groovy/groovy-core* panel. When you look at your own *GitHub* home page, you'll see the list of your forked repos and any new repos you make.

.Fork Groovy Core on *GitHub*
image::assets/img/repolist.png[List of Repos, link="https://github.com/apache/incubator-groovy",align="center"]
image::assets/img/repolist.png[List of Repos, link="https://github.com/apache/groovy",align="center"]

You now have your own version of [blue]#Groovy# in your *GitHub* account on the remote server. Next, you'll want to bring a copy of it onto your local system. It's easier to work with documents and test cases that way.

Expand Down Expand Up @@ -496,7 +496,7 @@ As you update documents, you may need to see how it looks. Following the previou

Do you have a special interest, or know some areas where you have some knowledge or where your skills may be useful ? There are many areas where your expertise can be put to good use. Here's one idea.

Open the https://github.com/apache/incubator-groovy/tree/master/src/spec/doc[Groovy Documentation Tree]. There are a large number of document files, one for each core component and each separate sub-project extension within [blue]#Groovy#. These are simple text file (no funny stuff) in a markup syntax called *asciidoc*. Document files end with *.adoc*.
Open the https://github.com/apache/groovy/tree/master/src/spec/doc[Groovy Documentation Tree]. There are a large number of document files, one for each core component and each separate sub-project extension within [blue]#Groovy#. These are simple text file (no funny stuff) in a markup syntax called *asciidoc*. Document files end with *.adoc*.

'''

Expand Down Expand Up @@ -781,7 +781,7 @@ icon:thumbs-up[] Ok, let's review test cases next.

=== Review Current Tests

Review the https://github.com/apache/incubator-groovy/tree/master/src/spec/test[Test Case] folder. There may already be tests that cover your area of interest. Some were written before tag standards came into existence. It might be as simple as adding asciidoctor tags around a test method.
Review the https://github.com/apache/groovy/tree/master/src/spec/test[Test Case] folder. There may already be tests that cover your area of interest. Some were written before tag standards came into existence. It might be as simple as adding asciidoctor tags around a test method.

==== Change Known Test Cases

Expand Down Expand Up @@ -992,9 +992,9 @@ Follow the directions given in link:groovy-contributions.html#_stand_and_declare

==== Groovy *PULL* Requests

In a browser, enter https://github.com/apache/incubator-groovy[https://github.com/apache/incubator-groovy] to see the *groovy-core* home page in *GitHub*. It's where we can get to the feature to ask our changes to be merged.
In a browser, enter https://github.com/apache/groovy[https://github.com/apache/groovy] to see the *groovy-core* home page in *GitHub*. It's where we can get to the feature to ask our changes to be merged.

image::assets/img/example2.png[GitHub Groovy-core, 794, 182, align="center", link="https://github.com/apache/incubator-groovy"]
image::assets/img/example2.png[GitHub Groovy-core, 794, 182, align="center", link="https://github.com/apache/groovy"]

Take a look here. See *[blue]#Pull Request#* +24+ ? This is where you can see how many other *PULL* requests are open, waiting to be done. Clicking +Pull Requests+ gives you the next view. The [white green-background]*New pull request* button is there

Expand All @@ -1004,7 +1004,7 @@ Take a look here. See *[blue]#Pull Request#* +24+ ? This is where you can see h

==== *PULL* The Other One

image::assets/img/example4.png[Groovy-core PULL list, 877, 463, align="center", link="https://github.com/apache/incubator-groovy/pulls"]
image::assets/img/example4.png[Groovy-core PULL list, 877, 463, align="center", link="https://github.com/apache/groovy/pulls"]

These are the current *PULL* requests for [blue]#Groovy#. Notice how each request has a title ? It's important to provide some idea about what a request will do.

Expand Down Expand Up @@ -1062,9 +1062,9 @@ Now, you've submitted your request to [blue]#Groovy# admins icon:user[] and rec

Again, do the same thing we did to create the request.

To follow the progress of your request, in a browser, enter https://github.com/apache/incubator-groovy[https://github.com/apache/incubator-groovy] to see the *groovy-core* home page in *GitHub*.
To follow the progress of your request, in a browser, enter https://github.com/apache/groovy[https://github.com/apache/groovy] to see the *groovy-core* home page in *GitHub*.

image::assets/img/example2.png[GitHub Groovy-core, 794, 182, align="center", link="https://github.com/apache/incubator-groovy"]
image::assets/img/example2.png[GitHub Groovy-core, 794, 182, align="center", link="https://github.com/apache/groovy"]

Look again. This is where you can saw how many other *PULL* requests were open, waiting to be done, including yours. Clicking +Pull Request+ took you to the next page for that view.

Expand All @@ -1075,7 +1075,7 @@ Look again. This is where you can saw how many other *PULL* requests were open,
==== The *PULL* List

.List Of Requests
image::assets/img/example4.png[Groovy-core PULL list, 877, 463, align="center", link="https://github.com/apache/incubator-groovy/pulls"]
image::assets/img/example4.png[Groovy-core PULL list, 877, 463, align="center", link="https://github.com/apache/groovy/pulls"]

Here are waiting *PULL* requests for [blue]#Groovy#. As this example is about adding *new Builder Documentation*, it was given a request number *488*. Look down the page to find it.

Expand Down
6 changes: 3 additions & 3 deletions src/spec/doc/type-checking-extensions.adoc
Expand Up @@ -1084,11 +1084,11 @@ type checking extensions and AST transformations.

Examples of real life type checking extensions are easy to find. You can download the source code for Groovy and
take a look at the
https://github.com/apache/incubator-groovy/blob/master/src/test/groovy/transform/stc/TypeCheckingExtensionsTest.groovy[TypeCheckingExtensionsTest]
https://github.com/apache/groovy/blob/master/src/test/groovy/transform/stc/TypeCheckingExtensionsTest.groovy[TypeCheckingExtensionsTest]
class which is linked to
https://github.com/apache/incubator-groovy/tree/master/src/test-resources/groovy/transform/stc[various extension scripts].
https://github.com/apache/groovy/tree/master/src/test-resources/groovy/transform/stc[various extension scripts].

An example of a complex type checking extension can be found in the link:markup-template-engine.html[Markup Template Engine]
source code: this template engine relies on a type checking extension and AST transformations to transform templates into
fully statically compiled code. Sources for this can be found
https://github.com/apache/incubator-groovy/tree/master/subprojects/groovy-templates/src/main/groovy/groovy/text/markup[here].
https://github.com/apache/groovy/tree/master/subprojects/groovy-templates/src/main/groovy/groovy/text/markup[here].