diff --git a/bramble-core/src/main/java/org/briarproject/bramble/crypto/StreamEncrypterImpl.java b/bramble-core/src/main/java/org/briarproject/bramble/crypto/StreamEncrypterImpl.java
index 55a4d0c6f0f2a7a78781d9736f478283b70a115a..5425c9486929bfdfa321a09a6a27f78a26a30de1 100644
--- a/bramble-core/src/main/java/org/briarproject/bramble/crypto/StreamEncrypterImpl.java
+++ b/bramble-core/src/main/java/org/briarproject/bramble/crypto/StreamEncrypterImpl.java
@@ -27,6 +27,7 @@ import static org.briarproject.bramble.util.ByteUtils.INT_64_BYTES;
 
 /**
  * See the BTP-Specs to understand whats going on here
+ * https://code.briarproject.org/briar/briar-spec/blob/master/protocols/BTP.md
  */
 @NotThreadSafe
 @NotNullByDefault
@@ -152,4 +153,4 @@ class StreamEncrypterImpl implements StreamEncrypter {
 		if (writeStreamHeader) writeStreamHeader();
 		out.flush();
 	}
-}
\ No newline at end of file
+}
diff --git a/bramble-core/src/main/java/org/briarproject/bramble/sync/SyncRecordWriterImpl.java b/bramble-core/src/main/java/org/briarproject/bramble/sync/SyncRecordWriterImpl.java
index 7b228e9f4ef9e970f3cdd83c4fd637f69e576a72..4e665d21687fdf5020752221634ddec3796e4096 100644
--- a/bramble-core/src/main/java/org/briarproject/bramble/sync/SyncRecordWriterImpl.java
+++ b/bramble-core/src/main/java/org/briarproject/bramble/sync/SyncRecordWriterImpl.java
@@ -28,6 +28,7 @@ import static org.briarproject.bramble.api.sync.SyncConstants.PROTOCOL_VERSION;
 
 /**
  * see the BSP-Specs
+ * https://code.briarproject.org/briar/briar-spec/blob/master/protocols/BSP.md
  */
 
 @NotThreadSafe
diff --git a/bramble-core/src/main/java/org/briarproject/bramble/transport/StreamWriterImpl.java b/bramble-core/src/main/java/org/briarproject/bramble/transport/StreamWriterImpl.java
index 66bf8a56830897750148c5f842a5b2229113508e..a88a76e5dc10206ff8691182d388a88b791fa6e2 100644
--- a/bramble-core/src/main/java/org/briarproject/bramble/transport/StreamWriterImpl.java
+++ b/bramble-core/src/main/java/org/briarproject/bramble/transport/StreamWriterImpl.java
@@ -22,7 +22,7 @@ class StreamWriterImpl extends OutputStream implements StreamWriter {
 
 	private final StreamEncrypter encrypter;
 	private final byte[] payload;
-	///@var length Stores how long the content that is currently in the buffer "payload" is.
+	/// length Stores how long the content that is currently in the buffer "payload" is.
 	private int length = 0;
 
 	StreamWriterImpl(StreamEncrypter encrypter) {
@@ -69,7 +69,8 @@ class StreamWriterImpl extends OutputStream implements StreamWriter {
 	@Override
 	public void write(byte[] b, int off, int len) throws IOException {
 		//Frame Segmentation
-		int available = payload.length - length; // available = How much free space ther is at the end of the buffer "payload"
+		// available = How much free space ther is at the end of the buffer "payload"
+		int available = payload.length - length;
 		while (available <= len) {
 			System.arraycopy(b, off, payload, length, available);
 			length += available;