Skip to content

chore(build): update dokka #45

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 0 additions & 14 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,6 @@ on:
description: Bump Version
default: 1.0.0
required: true
tweet:
description: extra text for tweet
required: false

# This allows a subsequently queued workflow run to interrupt previous runs
concurrency:
Expand Down Expand Up @@ -102,14 +99,3 @@ jobs:
version: ${{ github.event.inputs.version }}
message: ${{ github.event.inputs.version.description }}
token: ${{ secrets.GITHUB_TOKEN }}

- name: send tweet
uses: ethomson/send-tweet-action@v1
with:
status: |
🥳🪒📄 scrudbeans version ${{ github.event.inputs.version }} has just been released! 📢🙆🏻‍
${{ github.event.inputs.tweet }}
consumer-key: ${{ secrets.TWITTER_CONSUMER_API_KEY }}
consumer-secret: ${{ secrets.TWITTER_CONSUMER_API_SECRET }}
access-token: ${{ secrets.TWITTER_ACCESS_TOKEN }}
access-token-secret: ${{ secrets.TWITTER_ACCESS_TOKEN_SECRET }}
2 changes: 1 addition & 1 deletion deploy_website.sh
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ cp -R ./docs/ ./build/docs/
./gradlew dokkaGfmMultiModule

# Add readme as index
cat README.md > docs/index.md
cat README.md > ./build/docs/index.md

# Remove redundant link
sed -i '/Documentation at/d' ./build/docs/index.md
Expand Down
78 changes: 12 additions & 66 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,34 +4,10 @@ title: Installation

This document will help you get a quick start with ScrudBeans and Spring Boot.

## Using the Project Templates

The [scrudbeans-template-java](https://github.com/manosbatsis/scrudbeans-template-java) and
[scrudbeans-template-kotlin](https://github.com/manosbatsis/scrudbeans-template-kotlin) projects
replicates this quick tutorial and can help you get started with ScrudBeans right away.
> Both Maven and Gradle build scripts are included in the above samples.

For Kotlin:

```bash
git clone https://github.com/manosbatsis/scrudbeans-template-kotlin.git
```

For Java:

```bash
git clone https://github.com/manosbatsis/scrudbeans-template-java.git
```

## Using a Custom Project

Alternatively, you can use an existing Spring Boot project or create a new one with
[Spring Initializr](https://start.spring.io/).

## ScrudBeans Starter

If you are not using scrudbeans-template, the ScrudBeans autoconfiguration starter for
Spring Boot is all your project needs in terms of dependencies.
The `scrudbeans-spring-boot-starter` and `scrudbeans-annotation-processor-kotlin`
are all your project needs in terms of dependencies.

### Using Maven

Expand All @@ -42,26 +18,7 @@ __Starter__: To add the dependencies with Maven, begin with the Spring Boot star
<dependency>
<groupId>com.github.manosbatsis.scrudbeans</groupId>
<artifactId>scrudbeans-spring-boot-starter</artifactId>
<version>${scrudbeans.version}</version>
</dependency>
<!-- Test Starter -->
<dependency>
<groupId>com.github.manosbatsis.scrudbeans</groupId>
<artifactId>scrudbeans-spring-boot-starter-test</artifactId>
<version>${scrudbeans.version}</version>
<scope>test</scope>
</dependency>
```

__Java Processor__: If you use Java, add this annotation processor:

```xml
<!-- Provided/code generation Dependencies for Java -->
<dependency>
<groupId>com.github.manosbatsis.scrudbeans</groupId>
<artifactId>scrudbeans-annotation-processor-java</artifactId>
<version>${project.version}</version>
<scope>provided</scope>
<version>${scrudbeans_version}</version>
</dependency>
```

Expand All @@ -73,42 +30,31 @@ __Kotlin Processor__: If you use Kotlin, add this annotation processor:
<dependency>
<groupId>com.github.manosbatsis.scrudbeans</groupId>
<artifactId>scrudbeans-annotation-processor-kotlin</artifactId>
<version>${project.version}</version>
<version>${scrudbeans_version}</version>
<scope>provided</scope>
</dependency>
```

> You may have to setup apt or kapt for Java or Kotlin respectively,
> see [scrudbeans-template-java](https://github.com/manosbatsis/scrudbeans-template-java)
> and [scrudbeans-template-kotlin](https://github.com/manosbatsis/scrudbeans-template-kotlin)
> for examples.
> You may have to setup apt or kapt for Kotlin,
> see [scrudbeans-template-kotlin](https://github.com/manosbatsis/scrudbeans-template-kotlin)
> for an example.

### Using Gradle

If you use Java:

```groovy
dependencies {
//...
implementation 'com.github.manosbatsis.scrudbeans:scrudbeans-spring-boot-starter:$scrudbeans_version'
implementation("com.github.manosbatsis.scrudbeans:scrudbeans-annotation-processor-java:$scrudbeans_version")
}
```

If you use Kotlin:
Add the starter and annotation processor as an implementation and kapt dependency respectively:

```groovy
dependencies {
//...
implementation 'com.github.manosbatsis.scrudbeans:scrudbeans-spring-boot-starter:$scrudbeans_version'
implementation("com.github.manosbatsis.scrudbeans:scrudbeans-spring-boot-starter:$scrudbeans_version")
kapt("com.github.manosbatsis.scrudbeans:scrudbeans-annotation-processor-kotlin:$scrudbeans_version")
}
```

> You may have to setup apt or kapt for Java or Kotlin respectively,
> see [scrudbeans-template-java](https://github.com/manosbatsis/scrudbeans-template-java)
> and [scrudbeans-template-kotlin](https://github.com/manosbatsis/scrudbeans-template-kotlin)
> for examples.
> You may have to setup the Gradle kapt plugin if you have not already,
> see [scrudbeans-template-kotlin](https://github.com/manosbatsis/scrudbeans-template-kotlin)
> for an example.

## Application Properties

Expand Down
1 change: 1 addition & 0 deletions scrudbeans-api/build.gradle.kts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
plugins {
`java-library`
alias(libs.plugins.kotlin.jvm)
alias(libs.plugins.dokka)
// id("org.springframework.boot")
buildsrc.convention.`publish-jvm`
}
Expand Down
1 change: 1 addition & 0 deletions scrudbeans-common/build.gradle.kts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
plugins {
`java-library`
alias(libs.plugins.kotlin.jvm)
alias(libs.plugins.dokka)
buildsrc.convention.`publish-jvm`
}

Expand Down
1 change: 1 addition & 0 deletions scrudbeans-jpa/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ plugins {
alias(libs.plugins.kotlin.jvm)
alias(libs.plugins.kotlin.spring)
alias(libs.plugins.kotlin.jpa)
alias(libs.plugins.dokka)
buildsrc.convention.`publish-jvm`
}

Expand Down
1 change: 1 addition & 0 deletions scrudbeans-spring-boot-autoconfigure/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ plugins {
`java-library`
alias(libs.plugins.kotlin.jvm)
alias(libs.plugins.kotlin.spring)
alias(libs.plugins.dokka)
buildsrc.convention.`publish-jvm`
}

Expand Down