diff --git a/include/git2/net.h b/include/git2/net.h
index 18dd2df09..164f0ac0a 100644
--- a/include/git2/net.h
+++ b/include/git2/net.h
@@ -29,6 +29,14 @@
 #include "oid.h"
 #include "types.h"
 
+/**
+ * @file git2/net.h
+ * @brief Git networking declarations
+ * @ingroup Git
+ * @{
+ */
+GIT_BEGIN_DECL
+
 #define GIT_DEFAULT_PORT "9418"
 
 /*
@@ -40,14 +48,6 @@
 #define GIT_DIR_FETCH 0
 #define GIT_DIR_PUSH 1
 
-/**
- * @file git2/net.h
- * @brief Git networking declarations
- * @ingroup Git
- * @{
- */
-GIT_BEGIN_DECL
-
 /**
  * Remote head description, given out on `ls` calls.
  */
@@ -64,6 +64,6 @@ struct git_headarray {
 	struct git_remote_head **heads;
 };
 
+/** @} */
 GIT_END_DECL
-
 #endif
diff --git a/include/git2/remote.h b/include/git2/remote.h
index 7775070d8..723ff8f0e 100644
--- a/include/git2/remote.h
+++ b/include/git2/remote.h
@@ -28,6 +28,14 @@
 #include "git2/common.h"
 #include "git2/repository.h"
 #include "git2/refspec.h"
+/**
+ * @file git2/remote.h
+ * @brief Git remote management functions
+ * @defgroup git_remote remote management functions
+ * @ingroup Git
+ * @{
+ */
+GIT_BEGIN_DECL
 
 /*
  * TODO: This functions still need to be implemented:
@@ -117,6 +125,6 @@ GIT_EXTERN(int) git_remote_ls(git_remote *remote, git_headarray *refs);
  */
 GIT_EXTERN(void) git_remote_free(struct git_remote *remote);
 
+/** @} */
 GIT_END_DECL
-
 #endif